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() 之前呼叫此函式不會產生任何作用。

另請參閱