Edit

IO_SESSION_STATE_INFORMATION structure (wdm.h)

  • Article

The IO_SESSION_STATE_INFORMATION structure contains information about the state of a user session.

Syntax

typedef struct _IO_SESSION_STATE_INFORMATION {
  ULONG            SessionId;
  IO_SESSION_STATE SessionState;
  BOOLEAN          LocalSession;
} IO_SESSION_STATE_INFORMATION, *PIO_SESSION_STATE_INFORMATION;

Members

SessionId

The session ID. This member contains the Terminal Services session identifier of a user session. The IoGetContainerInformation routine sets this member to the session ID of the session that is represented by the session object that the ContainerObject parameter of IoGetContainerInformation points to.

SessionState

The current state of the user session that is identified by SessionId. This member is set to one of the following IO_SESSION_STATE enumeration constants:

  • IoSessionStateCreated
  • IoSessionStateInitialized
  • IoSessionStateConnected
  • IoSessionStateDisconnected
  • IoSessionStateDisconnectedLoggedOn
  • IoSessionStateLoggedOn
  • IoSessionStateLoggedOff
  • IoSessionStateTerminated

LocalSession

Indicates whether the user session identified by SessionId is a local session. If TRUE, the user is logged on locally. If FALSE, the user is logged on remotely. This member is valid only if the session is connected. The following IO_SESSION_STATE enumeration constants represent session states in which the session is connected:

  • IoSessionStateConnected
  • IoSessionStateLoggedOn
  • IoSessionStateLoggedOff

Remarks

To obtain information about a user session, a driver calls the IoGetContainerInformation routine. This routine's Buffer parameter points to an IO_SESSION_STATE_INFORMATION structure that contains information about the session state.

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)

See also

IO_SESSION_STATE

IoGetContainerInformation