énumération IO_SESSION_STATE (wdm.h)

Article
02/07/2025

L’énumération IO_SESSION_STATE contient des constantes qui indiquent l’état actuel d’une session utilisateur.

Syntaxe

typedef enum _IO_SESSION_STATE {
  IoSessionStateCreated,
  IoSessionStateInitialized,
  IoSessionStateConnected,
  IoSessionStateDisconnected,
  IoSessionStateDisconnectedLoggedOn,
  IoSessionStateLoggedOn,
  IoSessionStateLoggedOff,
  IoSessionStateTerminated,
  IoSessionStateMax
} IO_SESSION_STATE, *PIO_SESSION_STATE;

Constantes


`IoSessionStateCreated` La session a été créée.
`IoSessionStateInitialized` La session a été initialisée mais n’a pas encore été créée.
`IoSessionStateConnected` La session est connectée, mais l’utilisateur n’a pas encore ouvert de session.
`IoSessionStateDisconnected` La session a été déconnectée.
`IoSessionStateDisconnectedLoggedOn` La session a été déconnectée pendant que l’utilisateur a été connecté.
`IoSessionStateLoggedOn` L’utilisateur est connecté à la session.
`IoSessionStateLoggedOff` L’utilisateur s’est déconnecté de la session.
`IoSessionStateTerminated` La session a été arrêtée.
`IoSessionStateMax` Spécifie la valeur maximale dans ce type d’énumération.

Remarques

Lorsqu’un pilote appelle la routine IoGetContainerInformation pour obtenir des informations sur une session utilisateur (InformationClass = IoSessionStateInformation), le gestionnaire d’E/S écrit une structure IO_SESSION_STATE_INFORMATION dans la mémoire tampon pointée par le paramètre de tampon de la routine. Le gestionnaire d’E/S définit le membre SessionState de cette structure sur une constante d’énumération IO_SESSION_STATE (autre que IoSessionStateMax).

Le tableau suivant montre les transitions d’état de session. Pour chaque transition d’état, le tableau affiche les éléments suivants :

Le de l’état (étiquette de colonne dans une zone grise)
Le à état (étiquette de ligne dans une zone grise)
Événement qui provoque la transition (entrée de table dans une zone blanche)

Une zone blanche vide indique qu’aucune transition ne peut se produire directement à partir du associé de'état au correspondant à l’état. Table répertoriant les transitions d’état de session

Table répertoriant les transitions d’état de session

Dans le tableau précédent, les de et de aux états sont représentés par des constantes d’énumération IO_SESSION_STATE et les événements sont représentés par des constantes d’énumération IO_SESSION_EVENT. Par exemple, si l’état de session est IoSessionStateConnected (abrégé en tant que « Connected » dans la table), un événement IoSessionEventLogon (abrégé en tant que « Logon ») entraîne une transition vers l’état IoSessionStateLoggedOn (abrégé en tant que « LoggedOn »). L’état de départ d’une nouvelle session est IoSessionStateInitialized (abrégé en tant que « Initialized »).

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge dans Windows 7 et versions ultérieures du système d’exploitation Windows.
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)

Voir aussi

IO_SESSION_EVENT

IO_SESSION_STATE_INFORMATION

IoGetContainerInformation

Partager via