共用方式為


deleteTimerQueueEx 函式 (threadpoollegacyapiset.h)

刪除定時器佇列。 佇列中的任何暫止定時器會取消並刪除。

語法

BOOL DeleteTimerQueueEx(
  [in]           HANDLE TimerQueue,
  [in, optional] HANDLE CompletionEvent
);

參數

[in] TimerQueue

定時器佇列的句柄。 CreateTimerQueue 函式會傳回此句柄。

[in, optional] CompletionEvent

當函式成功且所有回呼函式都已完成時,要發出訊號的事件物件句柄。 此參數可以是 Null

如果此參數 INVALID_HANDLE_VALUE,函式會等候所有回呼函式完成再傳回。

如果此參數為 NULL,函式會將定時器標示為刪除,並立即傳回。 不過,大部分的呼叫端都應該等候回呼函式完成,以便執行任何必要的清除。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

請勿在定時器回呼內對 DeleteTimerQueueEx 進行封鎖呼叫。

若要編譯使用此函式的應用程式,請將 _WIN32_WINNT 定義為0x0500或更新版本。 如需詳細資訊,請參閱 使用 Windows 標頭

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 threadpoollegacyapiset.h
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

CreateTimerQueue

DeleteTimerQueueTimer

同步處理函式

執行緒共用

定時器佇列