zx_handle_close_MANY

摘要

关闭多个手柄。

声明

#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 某个标识名无效,或者同一标识名 出现多次。

另请参阅