Funzione DebugProc

Articolo
07/01/2023

Funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione SetWindowsHookExA/SetWindowsHookExW . Il sistema chiama questa funzione prima di chiamare le procedure hook associate a qualsiasi tipo di hook. Il sistema passa informazioni sull'hook da chiamare alla routine hook DebugProc , che esamina le informazioni e determina se consentire la chiamata dell'hook.

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

Sintassi

LRESULT CALLBACK DebugProc(
  _In_ int    nCode,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

Parametri

nCode [in]
Tipo: int

Specifica se la routine hook deve elaborare il messaggio. Se nCode è HC_ACTION, la routine hook deve elaborare il messaggio. Se nCode è minore di zero, la routine hook deve passare il messaggio alla funzione CallNextHookEx senza ulteriori elaborazioni e deve restituire il valore restituito da CallNextHookEx.

wParam [in]
Tipo: WPARAM

Tipo di hook da chiamare. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
WH_CALLWNDPROC 4	Installa una routine hook che monitora i messaggi inviati a una routine finestra. Per altre informazioni, vedere la descrizione della procedura hook [CallWndProc](callwndproc.md).
WH_CALLWNDPROCRET 12	Installa una procedura hook che monitora i messaggi appena elaborati da una routine finestra. Per altre informazioni, vedere la descrizione della procedura di hook CallWndRetProc .
WH_CBT 5	Installa una procedura hook che riceve notifiche utili per un'applicazione CBT. Per altre informazioni, vedere la descrizione della procedura di hook [CBTProc](cbtproc.md).
WH_DEBUG 9	Installa una procedura hook utile per il debug di altre procedure hook. Per altre informazioni, vedere la descrizione della procedura di hook DebugProc .
WH_GETMESSAGE 3	Installa una procedura hook che monitora i messaggi inviati a una coda di messaggi. Per altre informazioni, vedere la descrizione della procedura di hookGetMsgProc .
WH_JOURNALPLAYBACK 1	Installa una routine hook che pubblica i messaggi registrati in precedenza da una procedura hook WH_JOURNALRECORD . Per altre informazioni, vedere la descrizione della procedura hook JournalPlaybackProc .
WH_JOURNALRECORD 0	Installa una routine hook che registra i messaggi di input inviati alla coda dei messaggi di sistema. Questo hook è utile per la registrazione di macro. Per altre informazioni, vedere la descrizione della procedura hook JournalRecordProc .
WH_KEYBOARD 2	Installa una routine hook che monitora i messaggi di sequenza di tasti. Per altre informazioni, vedere la descrizione della procedura hook KeyboardProc .
WH_MOUSE 7	Installa una procedura hook che monitora i messaggi del mouse. Per altre informazioni, vedere la descrizione della procedura hook [MouseProc](mouseproc.md).
WH_MSGFILTER -1	Installa una routine hook che monitora i messaggi generati in seguito a un evento di input in una finestra di dialogo, una finestra di messaggio, un menu o una barra di scorrimento. La procedura hook monitora questi messaggi solo per l'applicazione che ha installato la procedura hook. Per altre informazioni, vedere la procedura di hook [MessageProc](messageproc.md).
WH_SHELL 10	Installa una procedura hook che riceve notifiche utili per un'applicazione Shell. Per altre informazioni, vedere la descrizione della procedura hook [ShellProc](shellproc.md) e della sezione hook WH_SHELL .
WH_SYSMSGFILTER 6	Installa una routine hook che monitora i messaggi generati in seguito a un evento di input in una finestra di dialogo, una finestra di messaggio, un menu o una barra di scorrimento. La procedura hook monitora questi messaggi per tutte le applicazioni nel sistema. Per altre informazioni, vedere la descrizione della procedura di hook [SysMsgProc](sysmsgproc.md).

lParam [in]
Tipo: LPARAM

Puntatore a una struttura DEBUGHOOKINFO contenente i parametri da passare alla routine hook di destinazione.

Valore restituito

Digitare:****

Tipo: LRESULT

Per impedire al sistema di chiamare l'hook, la procedura hook deve restituire un valore diverso da zero. In caso contrario, la routine hook deve chiamare CallNextHookEx.

Commenti

Un'applicazione installa questa procedura di hook specificando il tipo di hook WH_DEBUG e il puntatore alla routine hook in una chiamata alla funzione SetWindowsHookExA/SetWindowsHookExW .

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winuser.h (include Windows.h)