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 在结构上有效，但不引用有效的句柄。例如，句柄值可能引用已关闭的句柄，也可能是在调用进程的句柄表中未分配的有效位模式。