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