Função CallMsgFilterW (winuser.h)

Artigo
07/01/2023

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 de 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 CallMsgFilterW(
  [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 os códigos de gancho definidos pelo sistema (MSGF_ e HC_) associados aos ganchos de WH_SYSMSGFILTER e WH_MSGFILTER .

Retornar valor

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 será diferente de zero.

Comentários

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 ganchos de WH_MSGFILTER e WH_SYSMSGFILTER.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-message-l1-1-0 (introduzido em Windows 8)