WTSINFOEX_LEVEL1_A structure (wtsapi32.h)

Contains extended information about a Remote Desktop Services session.

Syntax

typedef struct _WTSINFOEX_LEVEL1_A {
  ULONG                  SessionId;
  WTS_CONNECTSTATE_CLASS SessionState;
  LONG                   SessionFlags;
  CHAR                   WinStationName[WINSTATIONNAME_LENGTH + 1];
  CHAR                   UserName[USERNAME_LENGTH + 1];
  CHAR                   DomainName[DOMAIN_LENGTH + 1];
  LARGE_INTEGER          LogonTime;
  LARGE_INTEGER          ConnectTime;
  LARGE_INTEGER          DisconnectTime;
  LARGE_INTEGER          LastInputTime;
  LARGE_INTEGER          CurrentTime;
  DWORD                  IncomingBytes;
  DWORD                  OutgoingBytes;
  DWORD                  IncomingFrames;
  DWORD                  OutgoingFrames;
  DWORD                  IncomingCompressedBytes;
  DWORD                  OutgoingCompressedBytes;
} WTSINFOEX_LEVEL1_A, *PWTSINFOEX_LEVEL1_A;

Members

SessionId

The session identifier.

SessionState

A value of the WTS_CONNECTSTATE_CLASS enumeration type that specifies the connection state of a Remote Desktop Services session.

SessionFlags

The state of the session. This can be one or more of the following values.

WTS_SESSIONSTATE_UNKNOWN (4294967295 (0xFFFFFFFF))

The session state is not known.

WTS_SESSIONSTATE_LOCK (0 (0x0))

The session is locked.

WTS_SESSIONSTATE_UNLOCK (1 (0x1))

The session is unlocked.

Windows Server 2008 R2 and Windows 7:  Due to a code defect, the usage of the WTS_SESSIONSTATE_LOCK and WTS_SESSIONSTATE_UNLOCK flags is reversed. That is, WTS_SESSIONSTATE_LOCK indicates that the session is unlocked, and WTS_SESSIONSTATE_UNLOCK indicates the session is locked.

WinStationName[WINSTATIONNAME_LENGTH + 1]

A null-terminated string that contains the name of the window station for the session.

UserName[USERNAME_LENGTH + 1]

A null-terminated string that contains the name of the user who owns the session.

DomainName[DOMAIN_LENGTH + 1]

A null-terminated string that contains the name of the domain that the user belongs to.

LogonTime

The time that the user logged on to the session. This value is stored as a large integer that represents the number of 100-nanosecond intervals since January 1, 1601 Coordinated Universal Time (Greenwich Mean Time).

ConnectTime

The time of the most recent client connection to the session. This value is stored as a large integer that represents the number of 100-nanosecond intervals since January 1, 1601 Coordinated Universal Time.

DisconnectTime

The time of the most recent client disconnection to the session. This value is stored as a large integer that represents the number of 100-nanosecond intervals since January 1, 1601 Coordinated Universal Time.

LastInputTime

The time of the last user input in the session. This value is stored as a large integer that represents the number of 100-nanosecond intervals since January 1, 1601 Coordinated Universal Time.

CurrentTime

The time that this structure was filled. This value is stored as a large integer that represents the number of 100-nanosecond intervals since January 1, 1601 Coordinated Universal Time.

IncomingBytes

The number of bytes of uncompressed Remote Desktop Protocol (RDP) data sent from the client to the server since the client connected.

OutgoingBytes

The number of bytes of uncompressed RDP data sent from the server to the client since the client connected.

IncomingFrames

The number of frames of RDP data sent from the client to the server since the client connected.

OutgoingFrames

The number of frames of RDP data sent from the server to the client since the client connected.

IncomingCompressedBytes

The number of bytes of compressed RDP data sent from the client to the server since the client connected.

OutgoingCompressedBytes

The number of bytes of compressed RDP data sent from the server to the client since the client connected.

Requirements

See also

WTS_CONNECTSTATE_CLASS