共用方式為


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

另請參閱

CreateTimerQueue

CreateTimerQueueTimer

DeleteTimerQueueTimer

同步處理函式

執行緒共用

計時器佇列