Fonction UnhookWinEvent (winuser.h)

  • Article

Supprime une fonction de hook d’événement créée par un appel précédent à SetWinEventHook.

Syntaxe

BOOL UnhookWinEvent(
  [in] HWINEVENTHOOK hWinEventHook
);

Paramètres

[in] hWinEventHook

Type : HWINEVENTHOOK

Gérez le hook d’événement retourné dans l’appel précédent à SetWinEventHook.

Valeur retournée

Type : BOOL

En cas de réussite, retourne TRUE ; dans le cas contraire, retourne FALSE.

Trois erreurs courantes entraînent l’échec de cette fonction :

  • Le paramètre hWinEventHook est NULL ou non valide.
  • Le hook d’événements spécifié par hWinEventHook a déjà été supprimé.
  • UnhookWinEvent est appelé à partir d’un thread différent de l’appel d’origine à SetWinEventHook.

Remarques

Cette fonction supprime le hook d’événement spécifié par hWinEventHook qui empêche la fonction de rappel correspondante de recevoir d’autres notifications d’événements. Si le thread du client se termine, le système appelle automatiquement cette fonction.

Appelez cette fonction à partir du même thread que celui qui a installé le hook d’événement. UnhookWinEvent échoue s’il est appelé à partir d’un thread différent de l’appel qui correspond à SetWinEventHook.

Si WINEVENT_INCONTEXT a été spécifié lors de l’installation de ce hook d’événements, le système tente de décharger la DLL correspondante de tous les processus qui l’ont chargée. Bien que le déchargement ne se produise pas immédiatement, la fonction de hook n’est pas appelée après le retour d’UnhookWinEvent . Pour plus d’informations sur WINEVENT_INCONTEXT, consultez Fonctions de crochet en contexte.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Composant redistribuable Active Accessibility 1.3 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 95