Condividi tramite


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: 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)

    Vedi anche

    CallNextHookEx

    CallWndProc

    CallWndRetProc

    CBTProc

    DEBUGHOOKINFO

    GetMsgProc

    JournalPlaybackProc

    JournalRecordProc

    KeyboardProc

    MessageProc

    MouseProc

    SetWindowsHookExA/SetWindowsHookExW

    ShellProc

    SysMsgProc

    Hook