HOOKPROC-Rückruffunktion (winuser.h)

Eine anwendungsdefinierte oder bibliotheksdefinierte Rückruffunktion, die mit der SetWindowsHookEx-Funktion verwendet wird. Das System ruft diese Funktion auf, nachdem die SendMessage-Funktion aufgerufen wurde. Das Hook-Verfahren kann die Nachricht untersuchen; sie kann sie nicht ändern.

Der HOOKPROC-Typ definiert einen Zeiger auf diese Rückruffunktion. CallWndRetProc ist ein Platzhalter für den anwendungsdefinierte oder bibliotheksdefinierte Funktionsnamen.

Syntax

HOOKPROC Hookproc;

LRESULT Hookproc(
       int code,
  [in] WPARAM wParam,
  [in] LPARAM lParam
)
{...}

Parameter

code

[in] wParam

Typ: WPARAM

Gibt an, ob die Nachricht vom aktuellen Prozess gesendet wird. Wenn die Nachricht vom aktuellen Prozess gesendet wird, ist sie nicht null; andernfalls ist es NULL.

[in] lParam

Typ: LPARAM

Ein Zeiger auf eine CWPSTRUCT - oder CWPRETSTRUCT-Struktur , die Details zur Nachricht enthält, je nachdem, welcher Hooktyp beim Aufrufen der SetWindowsHookEx-Funktion angegeben wurde.

Rückgabewert

Typ: LRESULT

Wenn nCode kleiner als 0 ist, muss die Hook-Prozedur den von der CallNextHookEx-Funktion zurückgegebenen Wert zurückgeben.

Wenn nCode größer als oder gleich Null ist, wird dringend empfohlen, die CallNextHookEx-Funktion aufzurufen und den zurückgegebenen Wert zurückzugeben. andernfalls erhalten andere Anwendungen, die WH_CALLWNDPROCRET Hooks installiert haben, keine Hook-Benachrichtigungen und verhalten sich daher möglicherweise falsch. Wenn die Hook-Prozedur callNextHookEx nicht aufruft, sollte der Rückgabewert null sein.

Bemerkungen

Eine Anwendung installiert die Hook-Prozedur, indem sie den WH_CALLWNDPROC - oder WH_CALLWNDPROCRET Hook-Typ und einen Zeiger auf die Hook-Prozedur in einem Aufruf der SetWindowsHookEx-Funktion angibt.

Requirements

Siehe auch

CWPSTRUCT-Struktur, CWPRETSTRUCT-Struktur, CallNextHookEx-Funktion, CallWindowProcW-Funktion, CallWindowProcA-Funktion, SendMessage, SetWindowsHookEx, Hooks