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) |