Funzione DebugProc
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: intSpecifica 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: WPARAMTipo 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: LPARAMPuntatore 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) Vedi anche