HOOKPROC-Rückruffunktion (winuser.h)

Artikel
07/01/2023

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. Die Hookprozedur 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 anwendungsdefinierten 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 nichtzero; andernfalls ist es NULL.

[in] lParam

Typ: LPARAM

Ein Zeiger auf eine CWPRETSTRUCT-Struktur , die Details zur Nachricht enthält.

Rückgabewert

Typ: LRESULT

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

Wenn nCode größer 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 Hookbenachrichtigungen und verhalten sich daher möglicherweise falsch. Wenn die Hookprozedur CallNextHookEx nicht aufruft, sollte der Rückgabewert 0 sein.

Hinweise

Eine Anwendung installiert die Hookprozedur, indem sie den WH_CALLWNDPROCRET Hooktyp und einen Zeiger auf die Hookprozedur in einem Aufruf der SetWindowsHookEx-Funktion angibt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)

Siehe auch

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

Freigeben über