zx_timer_cancel [取消时间]

总结

取消计时器。

声明

#include <zircon/syscalls.h>

zx_status_t zx_timer_cancel(zx_handle_t handle);

说明

zx_timer_cancel() 用于取消通过 zx_timer_set() 启动的待处理计时器。

成功后,待处理计时器会被取消,ZX_TIMER_SIGNALED 信号将被取消断言。如果立即需要一个新的待处理计时器,而不是先调用 zx_timer_cancel(),请使用新的截止时间调用 zx_timer_set()

权限

handle 必须为 ZX_OBJ_TYPE_TIMER 类型,且具有 ZX_RIGHT_WRITE

返回值

zx_timer_cancel() 会在成功时返回 ZX_OK。如果失败,则返回负数错误值。

错误

ZX_ERR_BAD_HANDLE 句柄不是有效的句柄。

ZX_ERR_ACCESS_DENIED 句柄缺少正确的 ZX_RIGHT_WRITE

注意

zx_timer_set() 之前调用此函数不会产生任何影响。

另请参阅