WM_WTSSESSION_CHANGE Nachricht

Artikel
06/22/2023

Benachrichtigt Anwendungen über Änderungen im Sitzungszustand.

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

LRESULT CALLBACK WindowProc(
  HWND hWnd,       // handle to window
  UINT Msg,        // WM_WTSSESSION_CHANGE
  WPARAM wParam,   // session state change event
  LPARAM lParam    // session ID
);

Parameter

hWnd [in]: Handle zum Fenster.
Msg [in]: Gibt die Nachricht (WM_WTSSESSION_CHANGE) an.
wParam [in]: Statuscode, der den Grund beschreibt, warum die Benachrichtigung zur Änderung des Sitzungszustands gesendet wurde. Dieser Parameter kann einen der folgenden Werte annehmen.
WTS_CONSOLE_CONNECT (0x1): Die von lParam identifizierte Sitzung war mit dem Konsolenterminal oder der RemoteFX-Sitzung verbunden.
WTS_CONSOLE_DISCONNECT (0x2): Die von lParam identifizierte Sitzung wurde vom Konsolenterminal oder der RemoteFX-Sitzung getrennt.
WTS_REMOTE_CONNECT (0x3): Die von lParam identifizierte Sitzung wurde mit dem Remoteterminal verbunden.
WTS_REMOTE_DISCONNECT (0x4): Die von lParam identifizierte Sitzung wurde vom Remoteterminal getrennt.
WTS_SESSION_LOGON (0x5): Ein Benutzer hat sich bei der von lParam identifizierten Sitzung angemeldet.
WTS_SESSION_LOGOFF (0x6): Ein Benutzer hat die von lParam identifizierte Sitzung abgemeldet.
WTS_SESSION_LOCK (0x7): Die von lParam identifizierte Sitzung wurde gesperrt.
WTS_SESSION_UNLOCK (0x8): Die von lParam identifizierte Sitzung wurde entsperrt.
WTS_SESSION_REMOTE_CONTROL (0x9): Die von lParam identifizierte Sitzung hat ihre ferngesteuerte status geändert. Rufen Sie GetSystemMetrics auf, um die status zu bestimmen, und überprüfen Sie die Metrik SM_REMOTECONTROL.
WTS_SESSION_CREATE (0xA): Für die zukünftige Verwendung reserviert.
WTS_SESSION_TERMINATE (0xB): Für die zukünftige Verwendung reserviert.

lParam [in]

Der Bezeichner der Sitzung.

Rückgabewert

Der Rückgabewert wird ignoriert.

Bemerkungen

Diese Nachricht wird nur an Anwendungen gesendet, die sich zum Empfangen dieser Nachricht registriert haben, indem WTSRegisterSessionNotification aufgerufen wird.

Beispiele dafür, wie Anwendungen auf diese Nachricht reagieren können, sind das Freigeben oder Abrufen konsolenspezifischer Ressourcen, das Bestimmen, wie ein Bildschirm gezeichnet werden soll, oder das Auslösen von Konsolenanimationseffekten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Header	Winuser.h (windows.h einschließen)

Siehe auch

WTSRegisterSessionNotification
WTSUnRegisterSessionNotification