摘要
關閉帳號代碼。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_handle_close(zx_handle_t handle);
說明
zx_handle_close()
會關閉控制代碼,如果在沒有其他控制點的情況下,核心會收回基礎物件。
如果在待處理的 zx_object_wait_one()
或 zx_object_wait_many()
呼叫中使用帳號代碼,系統將取消等待。
關閉特殊「永不有效的帳號」ZX_HANDLE_INVALID
並非錯誤,類似於 free(NULL)
屬於有效呼叫。
使用 zx_handle_close()
關閉對等物件的最後一個控制代碼,可能會影響物件的對等點狀態 (如果有的話)。另請參閱 peered-objects。
權限
無。
傳回值
zx_handle_close()
會在成功時傳回 ZX_OK
。
錯誤
「ZX_ERR_BAD_HANDLE
」的帳號代碼無效。