Função SysMsgProc
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 .