Função DispatchMessageW (winuser.h)

Artigo
03/13/2024

Envia uma mensagem para um procedimento de janela. Normalmente, ele é usado para expedir uma mensagem recuperada pela função GetMessage .

Sintaxe

LRESULT DispatchMessageW(
  [in] const MSG *lpMsg
);

Parâmetros

[in] lpMsg

Tipo: const MSG*

Um ponteiro para uma estrutura que contém a mensagem.

Retornar valor

Tipo: LRESULT

O valor retornado especifica o valor retornado pelo procedimento de janela. Embora seu significado dependa da mensagem que está sendo expedida, o valor retornado geralmente é ignorado.

Comentários

A estrutura MSG deve conter valores de mensagem válidos. Se o parâmetro lpmsg apontar para uma mensagem WM_TIMER e o parâmetro lParam da mensagem WM_TIMER não for NULL, lParam apontará para uma função que é chamada em vez do procedimento de janela.

Observe que o aplicativo é responsável por recuperar e expedir mensagens de entrada para a caixa de diálogo. A maioria dos aplicativos usa o loop de mensagem main para isso. No entanto, para permitir que o usuário se mova para e selecione controles usando o teclado, o aplicativo deve chamar IsDialogMessage. Para obter mais informações, consulte Interface de teclado da caixa de diálogo.

Exemplos

Para obter um exemplo, consulte Criando um loop de mensagem.

Observação

O cabeçalho winuser.h define DispatchMessage 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 no Windows 8)