Função DebugProc

Artigo
07/01/2023

Uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca usada com a função SetWindowsHookExA/SetWindowsHookExW . O sistema chama essa função antes de chamar os procedimentos de gancho associados a qualquer tipo de gancho. O sistema passa informações sobre o gancho a ser chamado para o procedimento de gancho DebugProc , que examina as informações e determina se o gancho deve ser chamado.

O tipo HOOKPROC define um ponteiro para essa função de retorno de chamada. DebugProc é um espaço reservado para o nome da função definida pelo aplicativo ou pela biblioteca.

Sintaxe

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

Parâmetros

nCode [in]
Tipo: int

Especifica se o procedimento de gancho deve processar a mensagem. Se nCode for HC_ACTION, o procedimento de gancho deverá processar a mensagem. Se nCode for menor que zero, o procedimento de gancho deverá passar a mensagem para a função CallNextHookEx sem processamento adicional e deverá retornar o valor retornado por CallNextHookEx.

wParam [in]
Tipo: WPARAM

O tipo de gancho prestes a ser chamado. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
WH_CALLWNDPROC 4	Instala um procedimento de gancho que monitora mensagens enviadas para um procedimento de janela. Para obter mais informações, consulte a descrição do procedimento de gancho [CallWndProc](callwndproc.md).
WH_CALLWNDPROCRET 12	Instala um procedimento de gancho que monitora mensagens que acabaram de ser processadas por um procedimento de janela. Para obter mais informações, consulte a descrição do procedimento de gancho CallWndRetProc .
WH_CBT 5	Instala um procedimento de gancho que recebe notificações úteis para um aplicativo CBT. Para obter mais informações, consulte a descrição do procedimento de gancho [CBTProc](cbtproc.md).
WH_DEBUG 9	Instala um procedimento de gancho útil para depurar outros procedimentos de gancho. Para obter mais informações, consulte a descrição do procedimento de gancho DebugProc .
WH_GETMESSAGE 3	Instala um procedimento de gancho que monitora mensagens postadas em uma fila de mensagens. Para obter mais informações, consulte a descrição do procedimento de ganchoGetMsgProc .
WH_JOURNALPLAYBACK 1	Instala um procedimento de gancho que posta mensagens registradas anteriormente por um procedimento de gancho de WH_JOURNALRECORD . Para obter mais informações, consulte a descrição do procedimento de gancho JournalPlaybackProc .
WH_JOURNALRECORD 0	Instala um procedimento de gancho que registra mensagens de entrada postadas na fila de mensagens do sistema. Esse gancho é útil para gravar macros. Para obter mais informações, consulte a descrição do procedimento de gancho JournalRecordProc .
WH_KEYBOARD 2	Instala um procedimento de gancho que monitora mensagens de pressionamento de tecla. Para obter mais informações, consulte a descrição do procedimento de gancho KeyboardProc .
WH_MOUSE 7	Instala um procedimento de gancho que monitora mensagens do mouse. Para obter mais informações, consulte a descrição do procedimento de gancho [MouseProc](mouseproc.md).
WH_MSGFILTER -1	Instala um procedimento de gancho que monitora mensagens geradas como resultado de um evento de entrada em uma caixa de diálogo, caixa de mensagem, menu ou barra de rolagem. O procedimento de gancho monitora essas mensagens somente para o aplicativo que instalou o procedimento de gancho. Para obter mais informações, consulte o procedimento de gancho [MessageProc](messageproc.md).
WH_SHELL 10	Instala um procedimento de gancho que recebe notificações úteis para um aplicativo Shell. Para obter mais informações, consulte a descrição do procedimento de gancho [ShellProc](shellproc.md) e a seção gancho de WH_SHELL .
WH_SYSMSGFILTER 6	Instala um procedimento de gancho que monitora mensagens geradas como resultado de um evento de entrada em uma caixa de diálogo, caixa de mensagem, menu ou barra de rolagem. O procedimento de gancho monitora essas mensagens para todos os aplicativos no sistema. Para obter mais informações, consulte a descrição do procedimento de gancho [SysMsgProc](sysmsgproc.md).

lParam [in]
Tipo: LPARAM

Um ponteiro para uma estrutura DEBUGHOOKINFO que contém os parâmetros a serem passados para o procedimento de gancho de destino.

Retornar valor

Tipo:****

Tipo: LRESULT

Para impedir que o sistema chame o gancho, o procedimento de gancho deve retornar um valor diferente de zero. Caso contrário, o procedimento de gancho deve chamar CallNextHookEx.

Comentários

Um aplicativo instala esse procedimento de gancho especificando o tipo de gancho WH_DEBUG e o ponteiro para o procedimento de gancho em uma chamada para a função SetWindowsHookExA/SetWindowsHookExW .

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Winuser.h (inclui Windows.h)