Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

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 that 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 is 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

Feedback

Was this page helpful?

Additional resources