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