Função SysMsgProc

Artigo
07/01/2023

Descrição

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 depois que um evento de entrada ocorre em uma caixa de diálogo, caixa de mensagem, menu ou barra de rolagem, mas antes que a mensagem gerada pelo evento de entrada seja processada. A função pode monitorar mensagens para qualquer caixa de diálogo, caixa de mensagem, menu ou barra de rolagem no sistema.

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

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

Parâmetros

nCode [in]

Tipo: int

O tipo de evento de entrada que gerou 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.

Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
MSGF_DIALOGBOX 0	O evento de entrada ocorreu em uma caixa de mensagem ou caixa de diálogo.
MSGF_MENU 2	O evento de entrada ocorreu em um menu.
MSGF_SCROLLBAR 5	O evento de entrada ocorreu em uma barra de rolagem.

wParam

Tipo: WPARAM

Este parâmetro não é usado.

lParam [in]

Tipo: LPARAM

Um ponteiro para uma estrutura de mensagens MSG .

Retornos

Tipo: LRESULT

Se nCode for menor que zero, o procedimento de gancho deverá retornar o valor retornado por CallNextHookEx.

Se nCode for maior ou igual a zero e o procedimento de gancho não processar a mensagem, é altamente recomendável que você chame CallNextHookEx e retorne o valor retornado; caso contrário, outros aplicativos que instalaram ganchos de WH_SYSMSGFILTER não receberão notificações de gancho e poderão se comportar incorretamente como resultado.

Se o procedimento de gancho tiver processado a mensagem, ele poderá retornar um valor diferente de zero para impedir que o sistema passe a mensagem para o procedimento da janela de destino.

Comentários

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