ChangeTimerQueueTimer-Funktion (threadpoollegacyapiset.h)
Updates einen Timer-Queue-Timer, der von der CreateTimerQueueTimer-Funktion erstellt wurde.
Syntax
BOOL ChangeTimerQueueTimer(
[in, optional] HANDLE TimerQueue,
[in, out] HANDLE Timer,
[in] ULONG DueTime,
[in] ULONG Period
);
Parameter
[in, optional] TimerQueue
Ein Handle für die Timerwarteschlange. Dieses Handle wird von der CreateTimerQueue-Funktion zurückgegeben.
Wenn dieser Parameter NULL ist, wird der Timer der Standardtimerwarteschlange zugeordnet.
[in, out] Timer
Ein Handle für den Timer-Warteschlangen-Timer. Dieses Handle wird von der CreateTimerQueueTimer-Funktion zurückgegeben.
[in] DueTime
Die Zeit, nach der der Timer in Millisekunden abläuft.
[in] Period
Der Zeitraum des Timers in Millisekunden. Wenn dieser Parameter 0 ist, wird der Timer einmal signalisiert. Wenn dieser Parameter größer als 0 ist, ist der Timer periodisch. Ein periodischer Timer reaktiviert automatisch jedes Mal, wenn der Zeitraum verstrichen ist, bis der Timer mithilfe der DeleteTimerQueueTimer-Funktion abgebrochen oder mit ChangeTimerQueueTimer zurückgesetzt wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Diese Funktion kann nicht aufgerufen werden, während der Thread einen Identitätswechsel verwendet. Das resultierende Verhalten ist nicht definiert.
Sie können ChangeTimerQueueTimer in einem Timer-Rückruf aufrufen.
Wenn Sie ChangeTimerQueueTimer für einen einmaligen Timer aufrufen (sein Zeitraum ist null), der bereits abgelaufen ist, wird der Timer nicht aktualisiert.
Rufen Sie ChangeTimerQueueTimer nicht auf, nachdem DeleteTimerQueueTimer für ein Handle aufgerufen wurde.
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0500 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | threadpoollegacyapiset.h |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |