BroadcastSystemMessage

Funkcja BroadcastSystemMessage wysyła wiadomość do określonych odbiorców. Adresatów można aplikacji, instalowalne sterowniki, sterowniki sieciowe, sterowniki urządzeń poziomie systemu lub dowolnej kombinacji tych składników systemu.

długie (BroadcastSystemMessage)  DWORD  dwFlags,  LPDWORD  lpdwRecipients,  UINT  uiMessage,  WPARAM  wParam,  FIKCYJNYMI  fikcyjnymi);
 

Parametry

dwFlags
Flagi opcji. Może być kombinacją następujących wartości:
Wartość Znaczenie
BSF_FLUSHDISK Opróżnianie dysku po każdy odbiorca przetwarza wiadomość.
BSF_FORCEIFHUNG Nadal można wyemitować komunikat, nawet wtedy, gdy upłynie limit czasu lub zawiesił się jednym z adresatów..
BSF_IGNORECURRENTTASK Nie należy wysyłać wiadomości do systemu windows, które należą do bieżącego zadania. Zapobiega to aplikacja z otrzymywania komunikatu.
BSF_NOHANG Życie uratowania zastosowania limitu czasu. Jeśli limit, jeden z adresatów czasu nie kontynuować nadawanie wiadomości.
BSF_NOTIMEOUTIFNOTHUNG Oczekiwania na odpowiedź na wiadomość, tak długo, jak długo adresata nie jest zawieszona. Nie wygasają.
BSF_POSTMESSAGE Ogłosić wiadomość. Nie należy używać w połączeniu z BSF_QUERY.
BSF_QUERY Wyślij wiadomość do jednego odbiorcy w czasie wysyłania do kolejnych adresata, tylko wtedy, gdy bieżący adresata zwraca TRUE.

lpdwRecipients
Wskaźnik do zmiennej, która zawiera i odbiera informacje adresatów wiadomości. Zmienna może być kombinacją następujących wartości:
Wartość Znaczenie
BSM_ALLCOMPONENTS Emisji dla wszystkich składników systemu.
BSM_ALLDESKTOPS Systemu Windows NT: Emisję wszystkich komputerów stacjonarnych. Wymaga przywileju SE_TCB_NAME.
BSM_APPLICATIONS Emisja do aplikacji.
BSM_INSTALLABLEDRIVERS Systemu Windows 95: Emisji do instalowalne sterowniki.
BSM_NETDRIVER Systemu Windows 95: Emisja do sterowników sieciowych.
BSM_VXDS Systemu Windows 95: Emisję wszystkich sterowników urządzenia systemowe.

Gdy funkcja zwraca, zmienna ta otrzymuje kombinacji tych wartości identyfikujące, których odbiorcy rzeczywiście otrzymane wiadomości.

Jeśli ten parametr ma wartość NULL, funkcja emisji dla wszystkich części składowych.

uiMessage
Identyfikator komunikatu systemu.
wParam
32-bitowe wartości specyficznych dla wiadomości.
fikcyjnymi
32-bitowe wartości specyficznych dla wiadomości.

Zwraca wartości

Jeśli funkcja, wartość zwracana jest wartość dodatnia.

Jeśli funkcja nie jest w stanie na nadawanie wiadomości, wartość zwracany jest –1.

Jeżeli parametr dwFlags jest BSF_QUERY i co najmniej jeden adresat zwrócony BROADCAST_QUERY_DENY do odpowiedniego komunikatu, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Jeśli BSF_QUERY nie jest określone, funkcja wysyła określoną wiadomość do wszystkich adresatów współpracujący, ignorowanie wartości zwracane przez tych beneficjentów.

Skrócone informacje

nbsp; Windows &NT: wymaga w wersji 4.0 lub nowszej.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Omówienie kolejek wiadomości i wiadomości, wiadomości i funkcje kolejki wiadomości

Index