摘要
關閉多個帳號代碼。
宣告
#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
其中一個「帳號代碼」不是有效的帳號代碼,或是同一個帳號代碼出現多次。