KillTimer, fonction (winuser.h)

Article
08/27/2023

Détruit le minuteur spécifié.

Syntaxe

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

Paramètres

[in, optional] hWnd

Type : HWND

Handle de la fenêtre associée au minuteur spécifié. Cette valeur doit être identique à la valeur hWnd passée à la fonction SetTimer qui a créé le minuteur.

[in] uIDEvent

Type : UINT_PTR

Minuteur à détruire. Si le handle de fenêtre passé à SetTimer est valide, ce paramètre doit être identique à nIDEvent

valeur passée à SetTimer. Si l’application appelle SetTimer avec hWnd défini sur NULL, ce paramètre doit être l’identificateur du minuteur retourné par SetTimer.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction KillTimer ne supprime pas WM_TIMER messages déjà publiés dans la file d’attente de messages.

Exemples

Pour obtenir un exemple, consultez Destruction d’un minuteur.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-2 (introduit dans Windows 10, version 10.0.10240)