WTSINFOA structure (wtsapi32.h)

Contains information about a Remote Desktop Services session.

Syntax

typedef struct _WTSINFOA {
  WTS_CONNECTSTATE_CLASS State;
  DWORD                  SessionId;
  DWORD                  IncomingBytes;
  DWORD                  OutgoingBytes;
  DWORD                  IncomingFrames;
  DWORD                  OutgoingFrames;
  DWORD                  IncomingCompressedBytes;
  DWORD                  OutgoingCompressedBy;
  CHAR                   WinStationName[WINSTATIONNAME_LENGTH];
  CHAR                   Domain[DOMAIN_LENGTH];
  CHAR                   UserName[USERNAME_LENGTH + 1];
  LARGE_INTEGER          ConnectTime;
  LARGE_INTEGER          DisconnectTime;
  LARGE_INTEGER          LastInputTime;
  LARGE_INTEGER          LogonTime;
  LARGE_INTEGER          CurrentTime;
} WTSINFOA, *PWTSINFOA;

Members

State

A value of the WTS_CONNECTSTATE_CLASS enumeration type that indicates the session's current connection state.

SessionId

The session identifier.

IncomingBytes

Uncompressed Remote Desktop Protocol (RDP) data from the client to the server.

OutgoingBytes

Uncompressed RDP data from the server to the client.

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

Compressed RDP data from the client to the server.

OutgoingCompressedBy

WinStationName[WINSTATIONNAME_LENGTH]

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

Domain[DOMAIN_LENGTH]

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

UserName[USERNAME_LENGTH + 1]

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

ConnectTime

The most recent client connection time.

DisconnectTime

The last client disconnection time.

LastInputTime

The time of the last user input in the session.

LogonTime

The time that the user logged on to the session.

CurrentTime

The time that the WTSINFO data structure was called.

Remarks

Note

The wtsapi32.h header defines WTSINFO as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows Vista with SP1
Minimum supported server Windows Server 2008
Header wtsapi32.h