摘要
关闭多个手柄。
声明
#include <zircon/syscalls.h>
zx_status_t zx_handle_close_many(const zx_handle_t* handles,
size_t num_handles);
说明
zx_handle_close_many()
会关闭多个句柄,导致每个句柄
要由内核回收的底层对象
存在。
如果标识名用于待处理的 zx_object_wait_one()
或
zx_object_wait_many()
调用时,等待将被取消。
此操作会关闭提供给它的所有标识名,即使其中一个或多个 标识名重复或无效。
关闭特殊“从未有效句柄”并非错误ZX_HANDLE_INVALID
,
类似于 free(NULL)
是有效调用。
使用 zx_handle_close_many()
关闭对等对象的最后一个句柄可以
会影响对象对等项(如果有)的状态。另请参阅
peered-objects。
权限
无。
返回值
如果成功,zx_handle_close_many()
会返回 ZX_OK
。
错误
ZX_ERR_BAD_HANDLE
某个标识名无效,或者同一标识名
出现多次。