IsWinEventHookInstalled, fonction (winuser.h)
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) |