Funzione KillTimer (winuser.h)

Articolo
08/27/2023

Elimina il timer specificato.

Sintassi

BOOL KillTimer(
  [in, optional] HWND     hWnd,
  [in]           UINT_PTR uIDEvent
);

Parametri

[in, optional] hWnd

Tipo: HWND

Handle alla finestra associata al timer specificato. Questo valore deve essere uguale al valore hWnd passato alla funzione SetTimer che ha creato il timer.

[in] uIDEvent

Tipo: UINT_PTR

Timer da distruggere. Se l'handle di finestra passato a SetTimer è valido, questo parametro deve essere uguale a nIDEvent

valore passato a SetTimer. Se l'applicazione chiama SetTimer con hWnd impostato su NULL, questo parametro deve essere l'identificatore timer restituito da SetTimer.

Valore restituito

Tipo: BOOL

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

La funzione KillTimer non rimuove WM_TIMER messaggi già pubblicati nella coda dei messaggi.

Esempio

Per un esempio, vedere Eliminazione di un timer.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-2 (introdotta in Windows 10, versione 10.0.10240)