UnhookWinEvent-Funktion (winuser.h)

  • Artikel

Entfernt eine Ereignishakenfunktion, die durch einen vorherigen Aufruf von SetWinEventHook erstellt wurde.

Syntax

BOOL UnhookWinEvent(
  [in] HWINEVENTHOOK hWinEventHook
);

Parameter

[in] hWinEventHook

Typ: HWINEVENTHOOK

Handle mit dem Ereignishaken, der im vorherigen Aufruf von SetWinEventHook zurückgegeben wurde.

Rückgabewert

Typ: BOOL

Bei erfolgreicher Ausführung wird TRUE zurückgegeben. Gibt andernfalls FALSE zurück.

Drei häufige Fehler führen dazu, dass diese Funktion fehlschlägt:

  • Der hWinEventHook-Parameter ist NULL oder ungültig.
  • Der von hWinEventHook angegebene Ereignishaken wurde bereits entfernt.
  • UnhookWinEvent wird von einem Thread aufgerufen, der sich vom ursprünglichen Aufruf von SetWinEventHook unterscheidet.

Hinweise

Diese Funktion entfernt den vom hWinEventHook angegebenen Ereignishaken, der verhindert, dass die entsprechende Rückruffunktion weitere Ereignisbenachrichtigungen empfängt. Wenn der Thread des Clients endet, ruft das System diese Funktion automatisch auf.

Rufen Sie diese Funktion aus demselben Thread auf, der den Ereignishaken installiert hat. UnhookWinEvent schlägt fehl, wenn von einem anderen Thread als dem Aufruf aufgerufen wird, der SetWinEventHook entspricht.

Wenn bei der Installation dieses Ereignishakens WINEVENT_INCONTEXT angegeben wurde, versucht das System, die entsprechende DLL aus allen Prozessen zu entladen, die sie geladen haben. Obwohl das Entladen nicht sofort erfolgt, wird die Hookfunktion nach der Rückgabe von UnhookWinEvent nicht aufgerufen. Weitere Informationen zu WINEVENT_INCONTEXT finden Sie unter Kontextbezogene Hookfunktionen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
Verteilbare Komponente Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95