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() 关闭对等互连对象的最后一个句柄可能会影响 对象对等的状态（如果有）。另请参阅 peered-objects。

权限

无。

返回值

如果成功，zx_handle_close() 会返回 ZX_OK。

错误

ZX_ERR_BAD_HANDLE handle 不是有效的句柄。

另请参阅