BroadcastSystemMessage

A função BroadcastSystemMessage envia uma mensagem para os destinatários especificados. Os destinatários podem ser aplicativos, drivers instaláveis, drivers de rede, drivers de dispositivo de nível de sistema ou qualquer combinação desses componentes do sistema.

longo BroadcastSystemMessage ( DWORD  dwFlags,  out  lpdwRecipients,  UINT  uiMessage,  WPARAM  wParam,  LPARAM  lParam);
 

Parâmetros

dwFlags
Sinalizadores de opção. Pode ser uma combinação dos seguintes valores:
Valor Significado
BSF_FLUSHDISK Liberar o disco depois de cada destinatário processa a mensagem.
BSF_FORCEIFHUNG Continuar a transmitir a mensagem, mesmo que ultrapassado o período tempo limite ou um dos destinatários é pendurado..
BSF_IGNORECURRENTTASK Não envie a mensagem para janelas que pertencem à tarefa atual. Isso impede que um aplicativo receba sua própria mensagem.
BSF_NOHANG Força um aplicativo congelado para tempo limite. Se um dos destinatários de tempo limite, não continue transmitindo a mensagem.
BSF_NOTIMEOUTIFNOTHUNG Espere por uma resposta para a mensagem, enquanto o destinatário não está congelado. Fazer não expirar.
BSF_POSTMESSAGE Enviar a mensagem. Não utilizar em combinação com BSF_QUERY.
BSF_QUERY Enviar a mensagem para um destinatário ao mesmo tempo, enviando para um destinatário subseqüente somente se o destinatário atual retorna TRUE.

lpdwRecipients
Ponteiro para uma variável que contém e recebe informações sobre os destinatários da mensagem. A variável pode ser uma combinação dos seguintes valores:
Valor Significado
BSM_ALLCOMPONENTS Transmitido para todos os componentes do sistema.
BSM_ALLDESKTOPS Windows NT: Transmissão para todos os desktops. Requer o privilégio SE_TCB_NAME.
BSM_APPLICATIONS Para aplicativos de difusão.
BSM_INSTALLABLEDRIVERS Windows 95: Drivers de difusão para instalável.
BSM_NETDRIVER Windows 95: Para drivers de rede de difusão.
BSM_VXDS Windows 95: Transmitido para todos os drivers de dispositivo de nível de sistema.

Quando a função retorna, essa variável recebe uma combinação desses valores identificar quais destinatários realmente receberam a mensagem.

Se este parâmetro é NULL, a função transmite a todos os componentes.

uiMessage
Identificador de mensagem do sistema.
wParam
32-bit valor de mensagem-específicos.
lParam
32-bit valor de mensagem-específicos.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um valor positivo.

Se a função for incapaz de transmitir a mensagem, o valor de retorno é – 1.

Se a pasta dwFlags parâmetro é BSF_QUERY e pelo menos um destinatário retornado BROADCAST_QUERY_DENY para a mensagem correspondente, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se BSF_QUERY não for especificado, a função envia a mensagem especificada para todos os destinatários solicitados, ignorando valores retornados por esses destinatários.

QuickInfo

nbsp; Windows &NT: requer a versão 4.0 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de filas de mensagens e mensagens, mensagens e funções de fila de mensagem

Index