CreateTimerQueue 函式 (threadpoollegacyapiset.h)

建立定時器的佇列。 定時器佇列定時器是輕量型物件,可讓您指定要在指定時間呼叫的回呼函式。

Syntax

HANDLE CreateTimerQueue();

傳回值

如果函式成功,則傳回值是定時器佇列的句柄。 此句柄只能在需要定時器佇列句柄的函式中使用。

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

備註

若要將定時器新增至佇列,請呼叫 CreateTimerQueueTimer 函式。 若要從佇列中移除定時器,請呼叫 DeleteTimerQueueTimer 函式。

當您完成定時器佇列時,請呼叫 DeleteTimerQueueEx 函式來刪除定時器佇列。 佇列中的任何暫止定時器會取消並刪除。

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

範例

如需使用 CreateTimerQueue 的範例,請參閱 使用定時器佇列

規格需求

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

另請參閱

CreateTimerQueueTimer

DeleteTimerQueueEx

DeleteTimerQueueTimer

同步處理函式

執行緒共用

定時器佇列