Funzione di callback HOOKPROC (winuser.h)

Funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione SetWindowsHookEx . Il sistema chiama questa funzione dopo la chiamata della funzione SendMessage . La procedura hook può esaminare il messaggio; non può modificarlo.

Il tipo HOOKPROC definisce un puntatore a questa funzione di callback. CallWndRetProc è un segnaposto per il nome di funzione definito dall'applicazione o definito dalla libreria.

Sintassi

HOOKPROC Hookproc;

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

Parameters

code

[in] wParam

Tipo: WPARAM

Specifica se il messaggio viene inviato dal processo corrente. Se il messaggio viene inviato dal processo corrente, è diverso da zero; in caso contrario, è NULL.

[in] lParam

Tipo: LPARAM

Puntatore a una struttura CWPSTRUCT o CWPRETSTRUCT che contiene dettagli sul messaggio, a seconda del tipo di hook specificato durante la chiamata alla funzione SetWindowsHookEx .

Valore restituito

Tipo: LRESULT

Se nCode è minore di zero, la routine hook deve restituire il valore restituito dalla funzione CallNextHookEx.

Se nCode è maggiore o uguale a zero, è consigliabile chiamare la funzione CallNextHookEx e restituire il valore restituito; in caso contrario, altre applicazioni che hanno installato WH_CALLWNDPROCRET hook non riceveranno notifiche hook e potrebbero comportarsi in modo non corretto di conseguenza. Se la routine hook non chiama CallNextHookEx, il valore restituito deve essere zero.

Osservazioni:

Un'applicazione installa la procedura hook specificando il tipo di hook WH_CALLWNDPROC o WH_CALLWNDPROCRET e un puntatore alla routine hook in una chiamata alla funzione SetWindowsHookEx .

Requisiti

Requisito	Value
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (includere Windows.h)

Vedere anche

Struttura CWPSTRUCT, struttura CWPRETSTRUCT, funzione CallNextHookEx, funzione CallWindowProcW, funzione CallWindowProcA, SendMessage, SetWindowsHookEx, Hooks