WM_WTSSESSION_CHANGE message

Article
06/13/2023

Avertit les applications des modifications apportées à l’état de session.

La fenêtre reçoit ce message via sa fonction WindowProc .

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

Paramètres

hWnd [in]: Handle vers la fenêtre.
Msg [in]: Spécifie le message (WM_WTSSESSION_CHANGE).
wParam [in]: Code d’état décrivant la raison pour laquelle la notification de changement d’état de session a été envoyée. Ce paramètre peut prendre les valeurs suivantes.
WTS_CONSOLE_CONNECT (0x1): La session identifiée par lParam a été connectée au terminal de console ou à la session RemoteFX.
WTS_CONSOLE_DISCONNECT (0x2): La session identifiée par lParam a été déconnectée du terminal de console ou de la session RemoteFX.
WTS_REMOTE_CONNECT (0x3): La session identifiée par lParam était connectée au terminal distant.
WTS_REMOTE_DISCONNECT (0x4): La session identifiée par lParam a été déconnectée du terminal distant.
WTS_SESSION_LOGON (0x5): Un utilisateur s’est connecté à la session identifiée par lParam.
WTS_SESSION_LOGOFF (0x6): Un utilisateur a déconnecté la session identifiée par lParam.
WTS_SESSION_LOCK (0x7): La session identifiée par lParam a été verrouillée.
WTS_SESSION_UNLOCK (0x8): La session identifiée par lParam a été déverrouillée.
WTS_SESSION_REMOTE_CONTROL (0x9): La session identifiée par lParam a modifié son status contrôlé à distance. Pour déterminer le status, appelez GetSystemMetrics et case activée la métrique SM_REMOTECONTROL.
WTS_SESSION_CREATE (0xA): Réservé pour un usage futur.
WTS_SESSION_TERMINATE (0xB): Réservé pour un usage futur.

lParam [in]

Identificateur de la session.

Valeur retournée

La valeur de retour est ignorée.

Remarques

Ce message est envoyé uniquement aux applications qui se sont inscrites pour recevoir ce message en appelant WTSRegisterSessionNotification.

Parmi les exemples de la façon dont les applications peuvent répondre à ce message, citons la publication ou l’acquisition de ressources spécifiques à la console, la détermination de la façon dont un écran doit être peint ou le déclenchement d’effets d’animation de console.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Winuser.h (include Windows.h)

Voir aussi

WTSRegisterSessionNotification
WTSUnRegisterSessionNotification