Função CallMsgFilterW (winuser.h)

Artigo
20/11/2024

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

C++

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 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

Hooks

MSG

MessageProc

de referência de

SetWindowsHookEx

SysMsgProc

Partilhar via