Message de modification de WM _ WTSSESSION _

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

La fenêtre reçoit ce message par le biais de 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 [ dans]

Handle vers la fenêtre.

Message [ dans]

Spécifie le message (WM _ WTSSESSION _ change).

wParam [ dans]

Code d’état décrivant la raison de l’envoi de la notification de changement d’état de session. Ce paramètre peut prendre les valeurs suivantes.

WTS _ _Connexion à la console (0x1)

la session identifiée par lParam était connectée au terminal de la console ou à la session de RemoteFX.

WTS _ _Déconnexion de la console (0X2)

la session identifiée par lParam a été déconnectée du terminal de la console ou de la session de RemoteFX.

WTS _ _Connexion à distance (0x3)

La session identifiée par lParam était connectée au terminal distant.

WTS _ _Déconnexion à distance (0x4)

La session identifiée par lParam a été déconnectée du terminal distant.

WTS _ _Ouverture de session (0x5)

Un utilisateur s’est connecté à la session identifiée par lParam.

WTS _ _Fermeture de session (0x6)

Un utilisateur s’est déconnecté de la session identifiée par lParam.

WTS _ _Verrouillage de session (0x7)

La session identifiée par lParam a été verrouillée.

WTS _ _Déverrouillage de session (0x8)

La session identifiée par lParam a été déverrouillée.

WTS _ _ _ Contrôle à distance de session (0x9)

La session identifiée par lParam a modifié son état contrôlé à distance. Pour déterminer l’État, appelez GetSystemMetrics et vérifiez la métrique du _ REMOTECONTROL SM .

WTS _ _Création de session (0xA)

Réservé pour un usage futur.

WTS _ _Fin de session (0xB)

Réservé pour un usage futur.

lParam [ dans]

Identificateur de la session.

Valeur de retour

La valeur de retour est ignorée.

Notes

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

Des exemples de la façon dont les applications peuvent répondre à ce message incluent la libération 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 des effets d’animation de la console.

Spécifications

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

Voir aussi

WTSRegisterSessionNotification

WTSUnRegisterSessionNotification