Summary
Cancels async port notifications on an object.
Declaration
#include <zircon/syscalls.h>
zx_status_t zx_port_cancel(zx_handle_t handle,
zx_handle_t source,
uint64_t key);
Description
zx_port_cancel() is a non-blocking syscall that cancels
all pending zx_object_wait_async() operations made with source and key.
When this call succeeds no new packets from the object pointed by source with key will be delivered to handle, and pending queued packets that match source and key are removed from the port.
Rights
handle must be of type ZX_OBJ_TYPE_PORT and have ZX_RIGHT_WRITE.
Return value
zx_port_cancel() returns ZX_OK if cancellation succeeded and
either queued packets were removed or pending zx_object_wait_async() were
canceled.
Errors
ZX_ERR_BAD_HANDLE source or handle is not a valid handle.
ZX_ERR_WRONG_TYPE handle is not a port handle.
ZX_ERR_ACCESS_DENIED source or handle does not have ZX_RIGHT_WRITE.
ZX_ERR_NOT_SUPPORTED source is a handle that cannot be waited on.
ZX_ERR_NOT_FOUND if either no pending packets or pending
zx_object_wait_async() calls with source and key were found.