énumération IO_SESSION_STATE (wdm.h)

Article
02/27/2024

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

Syntax

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 ne s’est pas encore connecté.
`IoSessionStateDisconnected` La session a été déconnectée.
`IoSessionStateDisconnectedLoggedOn` La session a été déconnectée pendant que l’utilisateur était connecté.
`IoSessionStateLoggedOn` L’utilisateur est connecté à la session.
`IoSessionStateLoggedOff` L’utilisateur s’est déconnecté de la session.
`IoSessionStateTerminated` La session a été terminé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 Buffer 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 présente les transitions d’état de session. Pour chaque transition d’état, le tableau montre les éléments suivants :

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

Une zone blanche vide indique qu’aucune transition ne peut se produire directement de l’état associé de l’état vers l’état correspondant à . Transitions d’état de session répertoriant les tables

Transitions d’état de session répertoriant les tables

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

Configuration requise

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

Voir aussi

IO_SESSION_EVENT

IO_SESSION_STATE_INFORMATION

IoGetContainerInformation