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 |