zx_handle_check_valid

摘要

檢查帳號代碼是否有效。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_handle_check_valid(zx_handle_t handle);

說明

檢查 handle 是否為有效的控制代碼值，參照有效的控制代碼。

權限

無。

傳回值

如果 handle 有效，zx_handle_check_valid() 會傳回 ZX_OK。

錯誤

ZX_ERR_INVALID_ARGS 值 handle 為 ZX_HANDLE_INVALID (0)。

ZX_ERR_OUT_OF_RANGE ZX_HANDLE_FIXED_BITS_MASK (0b11) 中的其中一個位元為 0。這個範圍內的值一律不是有效的控制代碼值。 詳情請參閱控點。

ZX_ERR_NOT_FOUND 值 handle 在結構上有效，但未參照有效的控制代碼。舉例來說，控制代碼值可能參照已關閉的控制代碼，也可能是未在呼叫程序控制代碼資料表中分配的有效位元模式。