zx-handle_close_multiple

摘要

關閉多個帳號代碼。

宣告

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

另請參閱