摘要
取消计时器。
声明
#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_set()，而不是先调用 zx_timer_cancel()
并附上新的截止日期
权限
handle 的类型必须为 ZX_OBJ_TYPE_TIMER 且包含 ZX_RIGHT_WRITE。
返回值
如果成功，zx_timer_cancel() 会返回 ZX_OK。
如果失败，则返回负的错误值。
错误
ZX_ERR_BAD_HANDLE handle 不是有效的句柄。
ZX_ERR_ACCESS_DENIED handle 缺少正确的 ZX_RIGHT_WRITE。
注意
在 zx_timer_set() 之前调用此函数不会产生任何影响。