WM_ENDSESSION Nachricht
Die WM_ENDSESSION Nachricht wird an eine Anwendung gesendet, nachdem das System die Ergebnisse der WM_QUERYENDSESSION Nachricht verarbeitet. Die WM_ENDSESSION Nachricht informiert die Anwendung darüber, ob die Sitzung beendet wird.
Ein Fenster empfängt diese Nachricht ü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 zum Fenster.
-
uMsg
-
Der WM_ENDSESSION Bezeichner.
-
wParam
-
Wenn die Sitzung beendet wird, ist dieser Parameter WAHR; die Sitzung kann jederzeit enden, nachdem alle Anwendungen von der Verarbeitung dieser Nachricht zurückgegeben wurden. Andernfalls ist es FALSCH.
-
lParam
-
Dieser Parameter kann mindestens eine der folgenden Werte sein. 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 wParamTRUE ist, 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 das System gewartet werden muss, oder wenn Systemressourcen ausgelastet sind. Die Anwendung wird neu gestartet, wenn sie sich für den Neustart mit der Funktion RegisterApplicationRestart registriert hat. Weitere Informationen finden Sie unter Richtlinien für Anwendungen.
Wenn wParamFALSCH ist, sollte die Anwendung nicht heruntergefahren werden.- ENDSESSION_CRITICAL
- 0x40000000
Die Anwendung wird gezwungen, herunterzufahren. - ENDSESSION_LOGOFF
- 0x80000000
Der Benutzer ist abgemeldet. Weitere Informationen finden Sie unter "Abmelden". Beachten Sie, dass dieser Parameter ein Bitformat ist. Verwenden Sie einen bitweisen Vorgang, um diesen Wert zu testen; Testen Sie nicht auf Gleichheit.
Rückgabewert
Wenn eine Anwendung diese Nachricht verarbeitet, sollte sie null zurückgeben.
Bemerkungen
Anwendungen mit nicht gespeicherten Daten können 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 Zustand häufig speichern; Speichern Sie z. B. automatisch Daten zwischen vom Benutzer initiierten Speichervorgängen, um die Datenmenge zu reduzieren, die beim Herunterfahren gespeichert werden soll.
Die Anwendung muss die Funktion "DestroyWindow " oder "PostQuitMessage " nicht aufrufen, wenn die Sitzung beendet wird.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Header |
|
Weitere Informationen