BroadcastSystemMessage

De functie BroadcastSystemMessage stuurt een bericht naar de opgegeven geadresseerden. De geadresseerden kunnen toepassingen, Installeerbare stuurprogramma's, netwerkstuurprogramma's, systeem-niveau apparaatstuurprogramma's, of een willekeurige combinatie van deze systeemcomponenten.

lange BroadcastSystemMessage ()  DWORD  dwFlags,  LPDWORD  lpdwRecipients,  UINT  uiMessage,  WPARAM  wParam,  LPARAM  lParam);
 

Parameters

dwFlags
Optie vlaggen. Een combinatie van de volgende waarden kunnen worden:
Waarde Betekenis
BSF_FLUSHDISK De schijf spoelen na elke geadresseerde het bericht verwerkt.
BSF_FORCEIFHUNG Blijven de nieuwsbericht, zelfs als de time-outperiode is verstreken of een van de ontvangers is opgehangen..
BSF_IGNORECURRENTTASK Verzend het bericht niet naar windows die deel uitmaken van de huidige taak. Dit voorkomt dat een toepassing een eigen bericht ontvangen.
BSF_NOHANG Een vastgelopen programma time-out geforceerd. Als een van de ontvangers een time-out optreedt, niet doorgaan het bericht uitzenden.
BSF_NOTIMEOUTIFNOTHUNG Wachten op een reactie op het bericht, zo lang als de ontvanger niet is opgehangen. Kan geen time-out.
BSF_POSTMESSAGE Het bericht. Niet gebruiken in combinatie met BSF_QUERY.
BSF_QUERY Verzend het bericht naar één ontvanger op een moment, verzenden naar een volgende geadresseerde alleen als de huidige ontvanger TRUE retourneert.

lpdwRecipients
Aanwijzer naar een variabele die bevat en ontvangt informatie over de ontvangers van het bericht. De variabele kan bestaan uit een combinatie van de volgende waarden:
Waarde Betekenis
BSM_ALLCOMPONENTS Uitgezonden naar alle systeemcomponenten.
BSM_ALLDESKTOPS Windows NT: Uitgezonden op alle desktops. Vereist het voorrecht SE_TCB_NAME.
BSM_APPLICATIONS Broadcasten naar toepassingen.
BSM_INSTALLABLEDRIVERS Windows 95: Uitzending naar Installeerbare stuurprogramma 's.
BSM_NETDRIVER Windows 95: Broadcasten naar netwerkstuurprogramma 's.
BSM_VXDS Windows 95: Uitgezonden naar alle systeem-niveau apparaatstuurprogramma 's.

Wanneer de functie retourneert, ontvangt deze variabele een combinatie van deze waarden identificeren welke ontvangers het bericht daadwerkelijk heeft ontvangen.

Als deze parameter NULL is, broadcast de functie naar alle onderdelen.

uiMessage
Id van het systeembericht.
wParam
32-bits message-specifieke waarde.
lParam
32-bits message-specifieke waarde.

Retourwaarden

Als de functie slaagt, is de retourwaarde een positieve waarde.

Als de functie voor het uitzenden van het bericht niet in staat is, is de geretourneerde waarde –1.

Als de parameter dwFlags BSF_QUERY is en ten minste één geadresseerde BROADCAST_QUERY_DENY keerde terug naar het bijbehorende bericht, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Als BSF_QUERY niet is opgegeven, verzendt de functie het opgegeven bericht naar alle gevraagde geadresseerden, het negeren van waarden die worden geretourneerd door deze geadresseerden.

Syntaxisinfo

nbsp; Windows &NT: versie 4.0 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Berichten en bericht wachtrijen overzicht, bericht en bericht wachtrij functies

Index