zx_handle_replace

Summary

Replace a handle.

Declaration

#include <zircon/syscalls.h>

zx_status_t zx_handle_replace(zx_handle_t handle,
                              zx_rights_t rights,
                              zx_handle_t* out);

Description

zx_handle_replace() creates a replacement for handle, referring to the same underlying object, with new access rights rights.

handle is always invalidated.

If rights is ZX_RIGHT_SAME_RIGHTS, the replacement handle will have the same rights as the original handle. Otherwise, rights must be a subset of original handle's rights.

Rights

None.

Return value

zx_handle_replace() returns ZX_OK and the replacement handle (via out) on success.

Errors

ZX_ERR_BAD_HANDLE handle isn't a valid handle.

ZX_ERR_INVALID_ARGS The rights requested are not a subset of handle's rights or out is an invalid pointer.

ZX_ERR_NO_MEMORY Failure due to lack of memory. There is no good way for userspace to handle this (unlikely) error. In a future build this error will no longer occur.

See also