IsWinEventHookInstalled-Funktion (winuser.h)

Bestimmt, ob ein installierter WinEvent-Hook vorhanden ist, der möglicherweise über ein angegebenes Ereignis benachrichtigt wird.

Syntax

BOOL IsWinEventHookInstalled(
  [in] DWORD event
);

Parameter

[in] event

Typ: DWORD

Die Ereigniskonstante, über die Hooks möglicherweise benachrichtigt werden. Die Funktion überprüft, ob ein hook für diese Ereigniskonstante installiert ist.

Rückgabewert

Typ: BOOL

Wenn ein Hook über das angegebene Ereignis benachrichtigt werden soll, ist der Rückgabewert TRUE.

Wenn keine Hooks über das angegebene Ereignis benachrichtigt werden sollen, lautet der Rückgabewert FALSE.

Hinweise

Diese Methode gibt garantiert niemals ein falsch negatives zurück. Wenn diese Methode FALSE zurückgibt, bedeutet dies, dass keine Hooks im System über das Ereignis benachrichtigt werden. Diese Methode gibt jedoch möglicherweise ein falsch positives Ergebnis zurück. Anders ausgedrückt: Es kann TRUE zurückgeben, obwohl keine Hooks vorhanden sind, die benachrichtigt werden. Daher ist es für Komponenten sicher, einige Arbeit zu umgehen, wenn diese Methode FALSE zurückgibt.

Ereignishooks können jederzeit installiert werden, sodass Serverentwickler den Rückgabewert nicht über einen längeren Zeitraum zwischenspeichern sollten.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h
Bibliothek	User32.lib
DLL	User32.dll
Verteilbare Komponente	Active Accessibility 2.0 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 98
APIs	ext-ms-win-ntuser-server-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

SetWinEventHook

UnhookWinEvent