ChangeTimerQueueTimer 函式 (threadpoollegacyapiset.h)
更新CreateTimerQueueTimer函式所建立的計時器佇列計時器。
語法
BOOL ChangeTimerQueueTimer(
[in, optional] HANDLE TimerQueue,
[in, out] HANDLE Timer,
[in] ULONG DueTime,
[in] ULONG Period
);
參數
[in, optional] TimerQueue
計時器佇列的控制碼。 CreateTimerQueue函式會傳回此控制碼。
如果此參數為 Null，計時器會與預設計時器佇列相關聯。
[in, out] Timer
計時器佇列計時器的控制碼。 CreateTimerQueueTimer函式會傳回這個控制碼。
[in] DueTime
計時器到期的時間，以毫秒為單位。
[in] Period
計時器的期間，以毫秒為單位。 如果此參數為零，計時器就會發出一次訊號。 如果此參數大於零，計時器會定期執行。 定期計時器會在每次經過期間時自動重新啟用，直到計時器使用 DeleteTimerQueueTimer 函式取消，或使用 ChangeTimerQueueTimer重設為止。
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
當執行緒使用模擬時，無法呼叫此函式。 產生的行為未定義。
您可以在計時器回呼中呼叫 ChangeTimerQueueTimer 。
如果您在單次計時器上呼叫 ChangeTimerQueueTimer ， (其期間為零) 已過期，則不會更新計時器。
請勿在控制碼上呼叫DeleteTimerQueueTimer 之後呼叫 ChangeTimerQueueTimer。
若要編譯使用此函式的應用程式，請將 _WIN32_WINNT 定義為0x0500或更新版本。 如需詳細資訊，請參閱 使用 Windows 標頭。
規格需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | threadpoollegacyapiset.h |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |