WM- _ endsitzungs Nachricht

Die WM- _ endsitzungs Nachricht wird an eine Anwendung gesendet, nachdem das System die Ergebnisse der WM _ queryendsession -Nachricht verarbeitet hat. Die WM- _ EndSession -Nachricht informiert die Anwendung darüber, ob die Sitzung beendet wird.

Ein Fenster empfängt diese Meldung über seine WindowProc -Funktion.

LRESULT CALLBACK WindowProc( 
  HWND hwnd,      // handle to window 
  UINT uMsg,      // message identifier 
  WPARAM wParam,  // end-session option 
  LPARAM lParam   // logoff option
);

Parameter

HWND

Ein Handle für das Fenster.

Umschlag

Der WM- _ endsitzungs Bezeichner.

wParam

Wenn die Sitzung beendet wird, ist dieser Parameter " true". die Sitzung kann jederzeit beendet werden, nachdem alle Anwendungen die Verarbeitung dieser Nachricht durchgeführt haben. Andernfalls ist Sie false.

lParam

Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen. Wenn dieser Parameter 0 ist, wird das System heruntergefahren oder neu gestartet (es ist nicht möglich, zu bestimmen, welches Ereignis auftritt).

Wert Bedeutung
EndSession _ CloseApp
0x1
Wenn wParam den Wert true hat, muss die Anwendung heruntergefahren werden. Alle Daten sollten automatisch gespeichert werden, ohne den Benutzer aufzufordern (Weitere Informationen finden Sie unter "Hinweise"). Der Neustart-Manager sendet diese Meldung, wenn die Anwendung eine Datei verwendet, die ersetzt werden muss, wenn Sie das System bedienen muss oder wenn die Systemressourcen erschöpft sind. Die Anwendung wird neu gestartet, wenn Sie sich für den Neustart mithilfe der RegisterApplicationRestart -Funktion registriert hat. Weitere Informationen finden Sie unter Richtlinien für Anwendungen.
Wenn wParam den Wert false hat, sollte die Anwendung nicht heruntergefahren werden.
EndSession _ Kritisch
0x40000000
Die Anwendung muss heruntergefahren werden.
EndSession _
Abmeldung
0x80000000
Der Benutzer meldet sich ab. Weitere Informationen finden Sie unter Abmelden.

Beachten Sie, dass dieser Parameter eine Bitmaske ist. Um diesen Wert zu testen, verwenden Sie einen bitweisen Vorgang. nicht auf Gleichheit testen.

Rückgabewert

Wenn eine Anwendung diese Nachricht verarbeitet, sollte Sie 0 (null) zurückgeben.

Bemerkungen

Anwendungen mit nicht gespeicherten Daten könnten die Daten an einem temporären Speicherort speichern und beim nächsten Start der Anwendung wiederherstellen. Es wird empfohlen, dass Anwendungen Ihre Daten und ihren Status häufig speichern. Beispielsweise werden Daten Zwischenspeicher Vorgängen, die vom Benutzer initiiert wurden, automatisch gespeichert, um die beim Herunterfahren zu speichernde Datenmenge zu verringern.

Die Anwendung muss die Funktion DestroyWindow oder PostQuitMessage nicht anrufen, wenn die Sitzung beendet wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
[UWP-Apps für Windows XP-Desktop-Apps |]
Unterstützte Mindestversion (Server)
Windows Server 2003 [ -Desktop-Apps | UWP-apps]
Header
Winuser. h (Windows. h einschließen)

Siehe auch

Abmelden

Wird heruntergefahren

DestroyWindow

PostQuitMessage

Setprocessshutdownparameters

WM- _ queryendsession