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