Funzione ChangeTimerQueueTimer (threadpoollegacyapiset.h)

Articolo
08/26/2023

Aggiornamenti un timer della coda timer creato dalla funzione CreateTimerQueueTimer.

Sintassi

BOOL ChangeTimerQueueTimer(
  [in, optional] HANDLE TimerQueue,
  [in, out]      HANDLE Timer,
  [in]           ULONG  DueTime,
  [in]           ULONG  Period
);

Parametri

[in, optional] TimerQueue

Handle per la coda timer. Questo handle viene restituito dalla funzione CreateTimerQueue .

Se questo parametro è NULL, il timer è associato alla coda timer predefinita.

[in, out] Timer

Handle per il timer della coda timer. Questo handle viene restituito dalla funzione CreateTimerQueueTimer .

[in] DueTime

Ora dopo la quale il timer deve scadere, in millisecondi.

[in] Period

Periodo del timer, in millisecondi. Se questo parametro è zero, il timer viene segnalato una volta. Se questo parametro è maggiore di zero, il timer è periodico. Un timer periodico reagisce automaticamente ogni volta che il periodo viene trascorso, fino a quando il timer non viene annullato usando la funzione DeleteTimerQueueTimer o reimpostando l'uso di ChangeTimerQueueTimer.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione non può essere chiamata mentre il thread usa la rappresentazione. Il comportamento risultante non è definito.

È possibile chiamare ChangeTimerQueueTimer in un callback timer.

Se si chiama ChangeTimerQueueTimer in un timer one-shot (il suo periodo è zero) che è già scaduto, il timer non viene aggiornato.

Non chiamare ChangeTimerQueueTimer dopo aver chiamato DeleteTimerQueueTimer su un handle.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	threadpoollegacyapiset.h
Libreria	Kernel32.lib
DLL	Kernel32.dll