Función ShellProc

Artículo
06/03/2023

Descripción

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 . La función recibe notificaciones de eventos de Shell del sistema.

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

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

Parámetros

nCode [in]

Tipo: int

Código de enlace.

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.

Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
HSHELL_ACCESSIBILITYSTATE 11	El estado de accesibilidad ha cambiado.
HSHELL_ACTIVATESHELLWINDOW 3	El shell debe activar su ventana principal.
HSHELL_APPCOMMAND 12	El usuario completó un evento de entrada (por ejemplo, presionó un botón de comando de aplicación en el mouse o una tecla de comando de aplicación en el teclado) y la aplicación no controló el mensaje de WM_APPCOMMAND generado por esa entrada. Si el procedimiento shell controla el mensaje de WM_COMMAND , no debe llamar a CallNextHookEx. Consulte la sección Valor devuelto para obtener más información.
HSHELL_GETMINRECT 5	Se está minimizando o maximizando una ventana. El sistema necesita las coordenadas del rectángulo minimizado para la ventana.
HSHELL_LANGUAGE 8	Se cambió el idioma del teclado o se cargó un nuevo diseño de teclado.
HSHELL_REDRAW 6	Se ha vuelto a dibujar el título de una ventana de la barra de tareas.
HSHELL_TASKMAN 7	El usuario ha seleccionado la lista de tareas. Una aplicación de shell que proporciona una lista de tareas debe devolver TRUE para evitar que Windows inicie su lista de tareas.
HSHELL_WINDOWACTIVATED 4	La activación ha cambiado a otra ventana de nivel superior sin propietario.
HSHELL_WINDOWCREATED 1	Se ha creado una ventana de nivel superior sin propietario. La ventana existe cuando el sistema llama a este enlace.
HSHELL_WINDOWDESTROYED 2	Una ventana de nivel superior sin propietario está a punto de destruirse. La ventana sigue existiendo cuando el sistema llama a este enlace.
HSHELL_WINDOWREPLACED 13	Se reemplaza una ventana de nivel superior. La ventana existe cuando el sistema llama a este enlace.

wParam [in]

Tipo: WPARAM

Este parámetro depende del valor del parámetro nCode , como se muestra en la tabla siguiente.

nCode	wParam
HSHELL_ACCESSIBILITYSTATE	Indica qué característica de accesibilidad ha cambiado de estado. Este valor es uno de los siguientes: ACCESS_FILTERKEYS, ACCESS_MOUSEKEYS o ACCESS_STICKYKEYS.
HSHELL_APPCOMMAND	Indica dónde se envió originalmente el mensaje WM_APPCOMMAND ; por ejemplo, el identificador de una ventana. Para obtener más información, consulte el parámetro cmd en WM_APPCOMMAND.
HSHELL_GETMINRECT	Identificador de la ventana minimizada o maximizada.
HSHELL_LANGUAGE	Un identificador de la ventana.
HSHELL_REDRAW	Identificador de la ventana de redrawn.
HSHELL_WINDOWACTIVATED	Identificador de la ventana activada.
HSHELL_WINDOWCREATED	Identificador de la ventana creada.
HSHELL_WINDOWDESTROYED	Identificador de la ventana destruida.
HSHELL_WINDOWREPLACED	Identificador de la ventana que se va a reemplazar. Windows 2000: no compatible.

lParam [in]

Tipo: LPARAM

Este parámetro depende del valor del parámetro nCode , como se muestra en la tabla siguiente.

nCode	lParam
HSHELL_APPCOMMAND	`GET_APPCOMMAND_LPARAM(lParam)` es el comando de aplicación correspondiente al evento de entrada. `GET_DEVICE_LPARAM(lParam)` indica lo que generó el evento de entrada; por ejemplo, el mouse o el teclado. Para obtener más información, consulte la descripción del parámetro uDevice en WM_APPCOMMAND. `GET_FLAGS_LPARAM(lParam)` depende del valor de cmd en WM_APPCOMMAND. Por ejemplo, podría indicar qué claves virtuales se mantuvieron inactivas cuando se envió originalmente el mensaje de WM_APPCOMMAND . Para obtener más información, consulte el parámetro de descripción dwCmdFlags en WM_APPCOMMAND.
HSHELL_GETMINRECT	Puntero a una estructura RECT .
HSHELL_LANGUAGE	Identificador de un diseño de teclado.
HSHELL_MONITORCHANGED	Identificador de la ventana que se movió a un monitor diferente.
HSHELL_REDRAW	El valor es TRUE si la ventana está parpadeando o FALSE en caso contrario.
HSHELL_WINDOWACTIVATED	El valor es TRUE si la ventana está en modo de pantalla completa o FALSE en caso contrario.
HSHELL_WINDOWREPLACED	Identificador de la nueva ventana. Windows 2000: no compatible.

Devoluciones

Tipo: LRESULT

El valor devuelto debe ser cero a menos que el valor de nCode sea HSHELL_APPCOMMAND y el procedimiento de shell controla el mensaje de WM_COMMAND . En este caso, el valor devuelto debe ser distinto de cero.

Comentarios

Instale este procedimiento de enlace especificando el tipo de enlace WH_SHELL y un puntero al procedimiento de enlace en una llamada a la función SetWindowsHookEx .