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 其中一個帳號代碼無效,或相同帳號代碼 多次存在

另請參閱