摘要
关闭多个手柄。
声明
#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 某个标识名无效,或者同一标识名
出现多次。