zx_handle_close_many

英文原文快照

名称

handle_close_many —— 关闭多个句柄

概要

  1. #include <zircon/syscalls.h>
  3. zx_status_t zx_handle_close_many(zx_handle_t* handles, size_t num_handles);

描述

handle_close() 操作关闭handles数组中的所有句柄，并触发内核回收所有没有其他句柄引用的底层对象。

如果handles在待处理的object_wait_one或object_wait_many调用中使用，则等待将被中止。

即使一个或多个句柄重复或无效，此操作也会关闭传递给它的所有句柄。

关闭特殊的“永远无效的句柄”(ZX_HANDLE_INVALID)不是错误，其类似于free(NULL)，是有效的调用。

权限

无需任何权限。

返回值

handle_close_many() 成功则返回ZX_OK。

错误码

ZX_ERR_BAD_HANDLE：handles中存在无效句柄，或同一句柄在handles中出现多次。

另见

handle_close，handle_duplicate，handle_replace。