Função SendMessageW (winuser.h)
Envia a mensagem especificada para uma janela ou janela. A função SendMessage chama o procedimento de janela da janela especificada e não retorna até que o procedimento de janela tenha processado a mensagem.
Para enviar uma mensagem e retornar imediatamente, use a função SendMessageCallback ou SendNotifyMessage. Para postar uma mensagem na fila de mensagens de um thread e retornar imediatamente, use a função postMessage ou postThreadMessage.
Sintaxe
LRESULT SendMessageW(
[in] HWND hWnd,
[in] UINT Msg,
[in] WPARAM wParam,
[in] LPARAM lParam
);
Parâmetros
[in] hWnd
Tipo: HWND
Um identificador para a janela cujo procedimento de janela receberá a mensagem. Se esse parâmetro for HWND_BROADCAST ((HWND)0xffff), a mensagem será enviada para todas as janelas de nível superior do sistema, incluindo janelas não semeadas desabilitadas ou invisíveis, janelas sobrepostas e janelas pop-up; mas a mensagem não é enviada para janelas filho.
O envio de mensagens está sujeito à UIPI. O thread de um processo pode enviar mensagens apenas para filas de mensagens de threads em processos de nível de integridade menor ou igual.
[in] Msg
Tipo: UINT
A mensagem a ser enviada.
Para obter listas das mensagens fornecidas pelo sistema, consulte System-Defined Mensagens.
[in] wParam
Tipo: WPARAM
Informações adicionais específicas da mensagem.
[in] lParam
Tipo: LPARAM
Informações adicionais específicas da mensagem.
Valor de retorno
Tipo: LRESULT
O valor retornado especifica o resultado do processamento da mensagem; depende da mensagem enviada.
Observações
Quando uma mensagem é bloqueada pela UIPI, o último erro, recuperado com GetLastError, é definido como 5 (acesso negado).
Os aplicativos que precisam se comunicar usando HWND_BROADCAST devem usar a função RegisterWindowMessage para obter uma mensagem exclusiva para comunicação entre aplicativos.
O sistema só faz marshalling para mensagens do sistema (aquelas no intervalo de 0 a (WM_USER-1)). Para enviar outras mensagens (aquelas >= WM_USER) para outro processo, você deve fazer o marshalling personalizado.
Se a janela especificada tiver sido criada pelo thread de chamada, o procedimento de janela será chamado imediatamente como uma sub-rotina. Se a janela especificada foi criada por um thread diferente, o sistema alterna para esse thread e chama o procedimento de janela apropriado. As mensagens enviadas entre threads são processadas somente quando o thread de recebimento executa o código de recuperação de mensagem. O thread de envio é bloqueado até que o thread de recebimento processe a mensagem. No entanto, o thread de envio processará mensagens não usadas de entrada enquanto aguarda sua mensagem ser processada. Para evitar isso, use SendMessageTimeout com SMTO_BLOCK definido. Para obter mais informações sobre mensagens não usadas, consulte mensagens não usadas.
Um aplicativo de acessibilidade pode usar SendMessage para enviar mensagens WM_APPCOMMAND para o shell para iniciar aplicativos. Essa funcionalidade não é garantida para funcionar para outros tipos de aplicativos.
Exemplos
Para obter um exemplo, consulte Exibindode entrada do teclado.
Nota
O cabeçalho winuser.h define SendMessage 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
mensagens e filas de mensagens
de referência de