Share via

IsWinEventHookInstalled, fonction (winuser.h)

  • Article

Détermine s’il existe un hook WinEvent installé qui peut être notifié d’un événement spécifié.

Syntaxe

BOOL IsWinEventHookInstalled(
  [in] DWORD event
);

Paramètres

[in] event

Type : DWORD

Constante d’événement dont les crochets peuvent être avertis. La fonction vérifie s’il existe un crochet installé pour cette constante d’événement.

Valeur retournée

Type : BOOL

S’il existe un hook à notifier de l’événement spécifié, la valeur de retour est TRUE.

S’il n’y a pas de crochets à notifier de l’événement spécifié, la valeur de retour est FALSE.

Remarques

Cette méthode est garantie pour ne jamais retourner un faux négatif. Si cette méthode retourne FALSE, cela signifie qu’aucun crochet dans le système n’est averti de l’événement. Toutefois, cette méthode peut retourner un faux positif. En d’autres termes, il peut retourner TRUE même s’il n’y a aucun crochet qui serait notifié. Par conséquent, il est sûr pour les composants de contourner certains travaux si cette méthode retourne FALSE.

Les hooks d’événements peuvent être installés à tout moment. Les développeurs de serveurs ne doivent donc pas mettre en cache la valeur de retour pendant de longues périodes.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h
Bibliothèque User32.lib
DLL User32.dll
Composant redistribuable Active Accessibility 2.0 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 98
Ensemble d’API ext-ms-win-ntuser-server-l1-1-1 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

SetWinEventHook

UnhookWinEvent