Função CallMsgFilterA (winuser.h)
Passa a mensagem especificada e o código de gancho para os procedimentos de gancho associados aos ganchos de WH_SYSMSGFILTER e WH_MSGFILTER. Um procedimento de gancho WH_SYSMSGFILTER ou WH_MSGFILTER é uma função de retorno de chamada definida pelo aplicativo que examina e, opcionalmente, modifica mensagens para uma caixa de diálogo, caixa de mensagem, menu ou barra de rolagem.
Sintaxe
BOOL CallMsgFilterA(
[in] LPMSG lpMsg,
[in] int nCode
);
Parâmetros
[in] lpMsg
Tipo: LPMSG
Um ponteiro para uma estrutura msg que contém a mensagem a ser passada para os procedimentos de gancho.
[in] nCode
Tipo: int
Um código definido pelo aplicativo usado pelo procedimento de gancho para determinar como processar a mensagem. O código não deve ter o mesmo valor que códigos de gancho definidos pelo sistema (MSGF_ e HC_) associados aos ganchos WH_SYSMSGFILTER e WH_MSGFILTER.
Valor de retorno
Tipo: BOOL
Se o aplicativo deve processar ainda mais a mensagem, o valor retornado será zero.
Se o aplicativo não deve processar a mensagem mais adiante, o valor retornado não será zero.
Observações
O sistema chama CallMsgFilter para permitir que os aplicativos examinem e controlem o fluxo de mensagens durante o processamento interno de caixas de diálogo, caixas de mensagem, menus e barras de rolagem ou quando o usuário ativa uma janela diferente pressionando a combinação de teclas ALT+TAB.
Instale esse procedimento de gancho usando a função SetWindowsHookEx.
Exemplos
Para obter um exemplo, consulte WH_MSGFILTER e WH_SYSMSGFILTER Hooks.
Nota
O cabeçalho winuser.h define CallMsgFilter como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winuser.h (inclua Windows.h) |
| biblioteca | User32.lib |
| de DLL |
User32.dll |
| conjunto de API | ext-ms-win-ntuser-message-l1-1-0 (introduzido no Windows 8) |
Consulte também
Conceitual
de referência de