IO_SESSION_STATE enumeration (wdm.h)

The IO_SESSION_STATE enumeration contains constants that indicate the current state of a user session.

Syntax

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

Constants


`IoSessionStateCreated` The session has been created.
`IoSessionStateInitialized` The session has been initialized but has not yet been created.
`IoSessionStateConnected` The session is connected but the user has not yet logged on.
`IoSessionStateDisconnected` The session has been disconnected.
`IoSessionStateDisconnectedLoggedOn` The session was disconnected while the user was logged on.
`IoSessionStateLoggedOn` The user is logged on to the session.
`IoSessionStateLoggedOff` The user has logged off of the session.
`IoSessionStateTerminated` The session has been terminated.
`IoSessionStateMax` Specifies the maximum value in this enumeration type.

Remarks

When a driver calls the IoGetContainerInformation routine to obtain information about a user session (InformationClass = IoSessionStateInformation), the I/O manager writes an IO_SESSION_STATE_INFORMATION structure to the buffer pointed to by the routine's Buffer parameter. The I/O manager sets the SessionState member of this structure to an IO_SESSION_STATE enumeration constant (other than IoSessionStateMax).

The following table shows the session state transitions. For each state transition, the table shows the following:

The from state (a column label in a gray box)
The to state (a row label in a gray box)
The event that causes the transition (a table entry in a white box)

A blank white box indicates that no transition can occur directly from the associated from state to the corresponding to state. Table listing session state transitions

In the preceding table, the from and to states are represented by IO_SESSION_STATE enumeration constants, and the events are represented by IO_SESSION_EVENT enumeration constants. For example, if the session state is IoSessionStateConnected (abbreviated as "Connected" in the table), an IoSessionEventLogon event (abbreviated as "Logon") causes a transition to the IoSessionStateLoggedOn state (abbreviated as "LoggedOn"). The starting state for a new session is IoSessionStateInitialized (abbreviated as "Initialized").

Requirements

Requirement	Value
Minimum supported client	Supported in Windows 7 and later versions of the Windows operating system.
Header	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)

Feedback

Was this page helpful?

Last updated on 2024-02-22