Freigeben über


WM_WTSSESSION_CHANGE Nachricht

Benachrichtigt Anwendungen über Änderungen im Sitzungszustand.

Das Fenster empfängt diese Nachricht über die 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
);

Die Parameter

hWnd [in]

Behandeln sie das Fenster.

Msg [in]

Gibt die Nachricht an (WM_WTSSESSION_CHANGE).

wParam [in]

Statuscode, der den Grund beschreibt, warum die Änderungsbenachrichtigung über den Sitzungszustand gesendet wurde. Dieser Parameter kann einer der folgenden Werte sein:

WTS_CONSOLE_CONNECT (0x1)

Die von lParam identifizierte Sitzung wurde 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 ihren remotegesteuerten Status geändert. Rufen Sie GetSystemMetrics auf, und überprüfen Sie die SM_REMOTECONTROL Metrik, um den Status zu ermitteln.

WTS_SESSION_CREATE (0xA)

Reserviert für zukünftige Verwendung.

WTS_SESSION_TERMINATE (0xB)

Reserviert für zukünftige Verwendung.

WTS_SESSION_DESKTOP_READY (0xF)

Die von lParam identifizierte Sitzung wurde auf den Desktop des Benutzers umgestellt.

lParam [in]

Der Bezeichner der Sitzung.

Rückgabewert

Der Rückgabewert wird ignoriert.

Bemerkungen

Diese Nachricht wird nur an Anwendungen gesendet, die registriert wurden, um diese Nachricht zu empfangen, indem SIE WTSRegisterSessionNotification aufrufen.

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

Anforderungen

Anforderung Wert
Mindest unterstützter Client
Windows Vista
Unterstützter Mindestserver
Windows Server 2008
Header
Winuser.h (enthalten Windows.h)

Siehe auch

WTSRegisterSessionNotification

WTSUnRegisterSessionNotification