Função DispatchMessageW (winuser.h)

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.

Valor de retorno

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.

Observações

A estrutura de 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 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 principal 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 do teclado da caixa de diálogo.

Exemplos

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

Nota

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

GetMessage

isDialogMessage

MSG

mensagens e filas de mensagens

PeekMessage

de referência de

TranslateMessage

WM_TIMER