Função DebugProc
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.
LRESULT CALLBACK DebugProc(
_In_ int nCode,
_In_ WPARAM wParam,
_In_ LPARAM lParam
);
nCode [in]
Tipo: intEspecifica 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: WPARAMO 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: LPARAMUm 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) Confira também