zx_handle_close

总结

关闭手柄。

声明

#include <zircon/syscalls.h>

zx_status_t zx_handle_close(zx_handle_t handle);

说明

zx_handle_close() 会关闭句柄,导致底层对象在没有其他句柄的情况下被内核收回。

如果该句柄用在了待处理的 zx_object_wait_one()zx_object_wait_many() 调用中,则等待将会取消。

关闭特殊的“绝不是有效句柄”ZX_HANDLE_INVALID(类似于 free(NULL) 是一个有效调用)不会是错误。

使用 zx_handle_close() 关闭对等互连对象的最后一个句柄可能会影响此对象对等互连对象(如果有)的状态。另请参阅对等互连对象

权限

无。

返回值

zx_handle_close() 会在成功时返回 ZX_OK

错误

ZX_ERR_BAD_HANDLE 句柄不是有效的句柄。

另请参阅