BroadcastSystemMessage

Funksjonen BroadcastSystemMessage sender en melding til de angitte mottakerne. Mottakerne kan være programmer, installerbare drivere, nettverksdrivere, systemnivå enhetsdrivere eller en kombinasjon av disse systemkomponentene.

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

Parametere

dwFlags

Alternativflagg. Kan være en kombinasjon av følgende verdier:

Verdi	Betydning
BSF_FLUSHDISK	Flush disken etter at hver mottaker behandler meldingen.
BSF_FORCEIFHUNG	Fortsette å kringkaste meldingen, selv om tidsavbruddsperioden utløper eller en av mottakerne henger..
BSF_IGNORECURRENTTASK	Ikke send meldingen til windows som tilhører gjeldende oppgave. Dette hindrer at et program mottar en egen melding.
BSF_NOHANG	Tvinge en hang program blir tidsavbrutt. Hvis en av mottakerne blir tidsavbrutt, betrakter ikke kringkaste meldingen.
BSF_NOTIMEOUTIFNOTHUNG	Vente på et svar på meldingen, så lenge mottakeren ikke henger. Tidsavbrutt.
BSF_POSTMESSAGE	Innlegget meldingen. Ikke bruk i kombinasjon med BSF_QUERY.
BSF_QUERY	Sende meldingen til én mottaker om gangen, og sender til en etterfølgende mottaker bare hvis gjeldende mottakeren returnerer SANN.

lpdwRecipients

Pekeren til en variabel som inneholder og mottar informasjon om mottakerne av meldingen. Variabelen kan være en kombinasjon av følgende verdier:

Verdi	Betydning
BSM_ALLCOMPONENTS	Kringkaste til alle systemkomponentene.
BSM_ALLDESKTOPS	Windows NT: Kringkaste til alle stasjonære PC-er. Krever SE_TCB_NAME-rettigheter.
BSM_APPLICATIONS	Kringkaste til programmer.
BSM_INSTALLABLEDRIVERS	Windows 95: Kringkasting til installerbare drivere.
BSM_NETDRIVER	Windows 95: Kringkaste til nettverksdrivere.
BSM_VXDS	Windows 95: Kringkaste til alle systemnivå enhetsdrivere.

Når funksjonen returnerer, mottar denne variabelen en kombinasjon av disse verdiene identifiserer hvilke mottakere faktisk mottok meldingen.

Hvis denne parameteren er NULL, sender funksjonen til alle komponenter.

uiMessage

Identifikator for systemmeldingen.

wParam

32-biters message-spesifikke verdi.

lParam

32-biters message-spesifikke verdi.

Returverdier

Hvis funksjonen lykkes, er returverdien en positiv verdi.

Hvis funksjonen ikke kan kringkaste meldingen, er verdien som returneres-1.

Hvis parameteren dwFlags er BSF_QUERY, og minst én mottaker tilbake BROADCAST_QUERY_DENY til den tilsvarende meldingen, er verdien som returneres Null. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Hvis BSF_QUERY ikke er angitt, sender funksjonen den angitte meldingen til alle forespurte mottakere, ignorerer verdier som returneres av disse mottakerne.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 4.0 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Meldinger og melding køer oversikt, meldingen og Message Queue-funksjoner

Index