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 |
|