Freigeben über


BroadcastSystemMessage-Funktion (winuser.h)

Sendet eine Nachricht an die angegebenen Empfänger. Die Empfänger können Anwendungen, installierbare Treiber, Netzwerktreiber, Gerätetreiber auf Systemebene oder eine beliebige Kombination dieser Systemkomponenten sein.

Verwenden Sie die BroadcastSystemMessageEx-Funktion , um zusätzliche Informationen zu erhalten, wenn die Anforderung definiert ist.

Syntax

long BroadcastSystemMessage(
  [in]                DWORD   flags,
  [in, out, optional] LPDWORD lpInfo,
  [in]                UINT    Msg,
  [in]                WPARAM  wParam,
  [in]                LPARAM  lParam
);

Parameter

[in] flags

Art: DWORD

Die Broadcastoption. Bei diesem Parameter kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
BSF_ALLOWSFW
0x00000080
Ermöglicht dem Empfänger, das Vordergrundfenster während der Verarbeitung der Nachricht festzulegen.
BSF_FLUSHDISK
0x00000004
Leert den Datenträger, nachdem jeder Empfänger die Nachricht verarbeitet hat.
BSF_FORCEIFHUNG
0x00000020
Die Nachricht wird weiterhin gesendet, auch wenn der Timeoutzeitraum abgelaufen ist oder einer der Empfänger nicht mehr antwortet.
BSF_IGNORECURRENTTASK
0x00000002
Sendet die Nachricht nicht an Fenster, die zur aktuellen Aufgabe gehören. Dadurch wird verhindert, dass eine Anwendung eine eigene Nachricht empfängt.
BSF_NOHANG
0x00000008
Erzwingt ein Timeout für eine nicht reagierende Anwendung. Wenn bei einem der Empfänger ein Zeitüberschreitungsüberschreitung besteht, sollten Sie die Übertragung der Nachricht nicht fortsetzen.
BSF_NOTIMEOUTIFNOTHUNG
0x00000040
Wartet auf eine Antwort auf die Nachricht, solange der Empfänger nicht reagiert. Gibt kein Timeout an.
BSF_POSTMESSAGE
0x00000010
Postet die Nachricht. Verwenden Sie nicht in Kombination mit BSF_QUERY.
BSF_QUERY
0x00000001
Sendet die Nachricht jeweils an einen Empfänger, der nur dann an einen nachfolgenden Empfänger gesendet wird, wenn der aktuelle Empfänger TRUE zurückgibt.
BSF_SENDNOTIFYMESSAGE
0x00000100
Sendet die Nachricht mithilfe der SendNotifyMessage-Funktion . Verwenden Sie nicht in Kombination mit BSF_QUERY.

[in, out, optional] lpInfo

Typ: LPDWORD

Ein Zeiger auf eine Variable, die Informationen über die Empfänger der Nachricht enthält und empfängt.

Wenn die Funktion zurückgegeben wird, empfängt diese Variable eine Kombination dieser Werte, die angibt, welche Empfänger die Nachricht tatsächlich empfangen haben.

Wenn dieser Parameter NULL ist, wird die Funktion an alle Komponenten übertragen.

Bei diesem Parameter kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
BSM_ALLCOMPONENTS
0x00000000
Übertragung an alle Systemkomponenten.
BSM_ALLDESKTOPS
0x00000010
Übertragen auf alle Desktops. Erfordert die Berechtigung SE_TCB_NAME .
BSM_APPLICATIONS
0x00000008
Übertragen an Anwendungen.

[in] Msg

Typ: UINT

Die zu sendende Nachricht.

Listen der vom System bereitgestellten Nachrichten finden Sie unter Systemdefinierte Nachrichten.

[in] wParam

Typ: WPARAM

Zusätzliche meldungsspezifische Informationen.

[in] lParam

Typ: LPARAM

Zusätzliche meldungsspezifische Informationen.

Rückgabewert

Typ: long

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein positiver Wert.

Wenn die Funktion die Nachricht nicht übertragen kann, ist der Rückgabewert –1.

Wenn der dwFlags-ParameterBSF_QUERY ist und mindestens ein Empfänger BROADCAST_QUERY_DENY an die entsprechende Nachricht zurückgegeben hat, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Bemerkungen

Wenn BSF_QUERY nicht angegeben ist, sendet die Funktion die angegebene Nachricht an alle angeforderten Empfänger, wobei die von diesen Empfängern zurückgegebenen Werte ignoriert werden.

Das System führt nur Marshalling für Systemmeldungen durch (die im Bereich von 0 bis (WM_USER-1)). Um andere Nachrichten (diese >= WM_USER) an einen anderen Prozess zu senden, müssen Sie benutzerdefiniertes Marshalling durchführen.

Beispiele

Ein Beispiel finden Sie unter Beenden eines Prozesses.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll

Siehe auch

BroadcastSystemMessageEx

Konzept

Nachrichten und Nachrichtenwarteschlangen

Referenz

SendNotifyMessage