Função SHSendMessageBroadcastA (shlwapi.h)

Artigo
11/20/2024

[Essa função está disponível por meio do Windows XP e do Windows Server 2003. Ele pode estar alterado ou indisponível nas versões subsequentes do Windows.]

Envia uma mensagem para todas as janelas de nível superior no sistema.

Sintaxe

LRESULT SHSendMessageBroadcastA(
  [in] UINT   uMsg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Parâmetros

[in] uMsg

Tipo: UINT

A mensagem a ser enviada.

[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 não é significativo.

Observações

SHSendMessageBroadcast é equivalente a SendMessage com HWND_BROADCAST. Para evitar que o Shell não responda no caso em que possa haver uma janela no sistema que não esteja respondendo às mensagens, use SHSendMessageBroadcast.

SHSendMessageBroadcast não é exportado por nome. SHSendMessageBroadcastA é exportado de Shlwapi.dll como ordinal 432. SHSendMessageBroadcastW é exportada de Shlwapi.dll como ordinal 433.

Nota

O cabeçalho shlwapi.h define SHSendMessageBroadcast 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 XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
de DLL	Shlwapi.dll (versão 5.0 ou posterior)

Compartilhar via