Función DebugProc

Artículo
07/01/2023

Función de devolución de llamada definida por la aplicación o definida por la biblioteca que se usa con la función SetWindowsHookExA/SetWindowsHookExW . El sistema llama a esta función antes de llamar a los procedimientos de enlace asociados a cualquier tipo de enlace. El sistema pasa información sobre el enlace al que se va a llamar al procedimiento de enlace DepurarProc , que examina la información y determina si se va a permitir que se llame al enlace.

El tipo HOOKPROC define un puntero a esta función de devolución de llamada. DebugProc es un marcador de posición para el nombre de función definido por la aplicación o definido por la biblioteca.

Sintaxis

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

Parámetros

nCode [in]
Tipo: int

Especifica si el procedimiento de enlace debe procesar el mensaje. Si nCode es HC_ACTION, el procedimiento de enlace debe procesar el mensaje. Si nCode es menor que cero, el procedimiento de enlace debe pasar el mensaje a la función CallNextHookEx sin procesamiento adicional y debe devolver el valor devuelto por CallNextHookEx.

wParam [in]
Tipo: WPARAM

Tipo de enlace al que se va a llamar. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
WH_CALLWNDPROC 4	Instala un procedimiento de enlace que supervisa los mensajes enviados a un procedimiento de ventana. Para obtener más información, vea la descripción del procedimiento de enlace [CallWndProc](callwndproc.md).
WH_CALLWNDPROCRET 12	Instala un procedimiento de enlace que supervisa los mensajes que acaba de procesar un procedimiento de ventana. Para obtener más información, vea la descripción del procedimiento de enlace CallWndRetProc .
WH_CBT 5	Instala un procedimiento de enlace que recibe notificaciones útiles para una aplicación CBT. Para obtener más información, vea la descripción del procedimiento de enlace [CBTProc](cbtproc.md).
WH_DEBUG 9	Instala un procedimiento de enlace útil para depurar otros procedimientos de enlace. Para obtener más información, vea la descripción del procedimiento de enlace DepurarProc .
WH_GETMESSAGE 3	Instala un procedimiento de enlace que supervisa los mensajes publicados en una cola de mensajes. Para obtener más información, consulte la descripción del procedimiento de enlaceGetMsgProc .
WH_JOURNALPLAYBACK 1	Instala un procedimiento de enlace que publica mensajes grabados previamente por un procedimiento de enlace de WH_JOURNALRECORD . Para obtener más información, consulte la descripción del procedimiento de enlace JournalPlaybackProc .
WH_JOURNALRECORD 0	Instala un procedimiento de enlace que registra los mensajes de entrada publicados en la cola de mensajes del sistema. Este enlace es útil para grabar macros. Para obtener más información, consulte la descripción del procedimiento de enlace JournalRecordProc .
WH_KEYBOARD 2	Instala un procedimiento de enlace que supervisa los mensajes de pulsación de tecla. Para obtener más información, vea la descripción del procedimiento de enlace KeyboardProc .
WH_MOUSE 7	Instala un procedimiento de enlace que supervisa los mensajes del mouse. Para obtener más información, vea la descripción del procedimiento de enlace [MouseProc](mouseproc.md).
WH_MSGFILTER -1	Instala un procedimiento de enlace que supervisa los mensajes generados como resultado de un evento de entrada en un cuadro de diálogo, cuadro de mensaje, menú o barra de desplazamiento. El procedimiento de enlace supervisa estos mensajes solo para la aplicación que instaló el procedimiento de enlace. Para obtener más información, vea el procedimiento de enlace [MessageProc](messageproc.md).
WH_SHELL 10	Instala un procedimiento de enlace que recibe notificaciones útiles para una aplicación de Shell. Para obtener más información, vea la descripción del procedimiento de enlace [ShellProc](shellproc.md) y la sección de enlace de WH_SHELL .
WH_SYSMSGFILTER 6	Instala un procedimiento de enlace que supervisa los mensajes generados como resultado de un evento de entrada en un cuadro de diálogo, cuadro de mensaje, menú o barra de desplazamiento. El procedimiento de enlace supervisa estos mensajes para todas las aplicaciones del sistema. Para obtener más información, vea la descripción del procedimiento de enlace [SysMsgProc](sysmsgproc.md).

lParam [in]
Tipo: LPARAM

Puntero a una estructura DEBUGHOOKINFO que contiene los parámetros que se van a pasar al procedimiento de enlace de destino.

Valor devuelto

Tipo:****

Tipo: LRESULT

Para evitar que el sistema llame al enlace, el procedimiento de enlace debe devolver un valor distinto de cero. De lo contrario, el procedimiento de enlace debe llamar a CallNextHookEx.

Comentarios

Una aplicación instala este procedimiento de enlace especificando el tipo de enlace WH_DEBUG y el puntero al procedimiento de enlace en una llamada a la función SetWindowsHookExA/SetWindowsHookExW .

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluya Windows.h)