WM_ENDSESSION Nachricht

Artikel
06/13/2023

Die WM_ENDSESSION Nachricht wird an eine Anwendung gesendet, nachdem das System die Ergebnisse der WM_QUERYENDSESSION Nachricht verarbeitet hat. Die WM_ENDSESSION Meldung 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.

uMsg

Der WM_ENDSESSION-Bezeichner .

wParam

Wenn die Sitzung beendet wird, ist dieser Parameter TRUE. Die Sitzung kann jederzeit beendet werden, nachdem alle Anwendungen von der Verarbeitung dieser Nachricht zurückgegeben wurden. Andernfalls ist es 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 eintritt).

Wert	Bedeutung
ENDSESSION_CLOSEAPP 0x1	Wenn wParamAUF TRUE festgelegt ist, muss die Anwendung heruntergefahren werden. Alle Daten sollten automatisch ohne Aufforderung des Benutzers gespeichert werden (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 die Systemressourcen erschöpft sind. Die Anwendung wird neu gestartet, wenn sie mit der RegisterApplicationRestart-Funktion zum Neustart registriert wurde. Weitere Informationen finden Sie unter Richtlinien für Anwendungen. Wenn wParamauf FALSE festgelegt ist, sollte die Anwendung nicht heruntergefahren werden.
ENDSESSION_CRITICAL 0x40000000	Die Anwendung muss heruntergefahren werden.
ENDSESSION_LOGOFF 0x80000000	Der Benutzer wird abgemeldet. Weitere Informationen finden Sie unter Abmelden.

Beachten Sie, dass es sich bei diesem Parameter um eine Bitmaske handelt. Verwenden Sie einen bitweisen Vorgang, um diesen Wert zu testen. nicht auf Gleichheit testen.

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 beispielsweise automatisch Daten zwischen vom Benutzer initiierten Speichervorgängen, um die Beim Herunterfahren zu speichernde Datenmenge zu reduzieren.

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

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	WinUser.h (windows.h einschließen)

Siehe auch

Abmelden
Herunterfahren
DestroyWindow
PostQuitMessage
SetProcessShutdownParameters
WM_QUERYENDSESSION

Freigeben über