WTSCLIENTA-Struktur (wtsapi32.h)

Enthält Informationen zu einem Remotedesktopverbindungsclient (RDC).

Syntax

typedef struct _WTSCLIENTA {
  CHAR   ClientName[CLIENTNAME_LENGTH + 1];
  CHAR   Domain[DOMAIN_LENGTH + 1];
  CHAR   UserName[USERNAME_LENGTH + 1];
  CHAR   WorkDirectory[MAX_PATH + 1];
  CHAR   InitialProgram[MAX_PATH + 1];
  BYTE   EncryptionLevel;
  ULONG  ClientAddressFamily;
  USHORT ClientAddress[CLIENTADDRESS_LENGTH + 1];
  USHORT HRes;
  USHORT VRes;
  USHORT ColorDepth;
  CHAR   ClientDirectory[MAX_PATH + 1];
  ULONG  ClientBuildNumber;
  ULONG  ClientHardwareId;
  USHORT ClientProductId;
  USHORT OutBufCountHost;
  USHORT OutBufCountClient;
  USHORT OutBufLength;
  CHAR   DeviceId[MAX_PATH + 1];
} WTSCLIENTA, *PWTSCLIENTA;

Angehörige

ClientName[CLIENTNAME_LENGTH + 1]

Der NetBIOS-Name des Clientcomputers.

Domain[DOMAIN_LENGTH + 1]

Der Domänenname des Clientcomputers.

UserName[USERNAME_LENGTH + 1]

Der Clientbenutzername.

WorkDirectory[MAX_PATH + 1]

Der Ordner für das anfängliche Programm.

InitialProgram[MAX_PATH + 1]

Das Programm, das bei der Verbindung gestartet werden soll.

EncryptionLevel

Die Sicherheitsstufe der Verschlüsselung.

ClientAddressFamily

Die Adressfamilie. Dieses Mitglied kann AF_INET, AF_INET6, AF_IPX, AF_NETBIOSoder AF_UNSPEC.

ClientAddress[CLIENTADDRESS_LENGTH + 1]

Die Clientnetzwerkadresse.

HRes

Horizontale Dimension (in Pixel) der Anzeige des Clients.

VRes

Vertikale Dimension (in Pixel) der Anzeige des Clients.

ColorDepth

Farbtiefe der Anzeige des Clients. Mögliche Werte finden Sie im ColorDepth- Element der WTS_CLIENT_DISPLAY Struktur.

ClientDirectory[MAX_PATH + 1]

Der Speicherort der ActiveX-Steuerelement-DLL des Clients.

ClientBuildNumber

Die Clientbuildnummer.

ClientHardwareId

Reserviert.

ClientProductId

Reserviert.

OutBufCountHost

Die Anzahl der Ausgabepuffer auf dem Server pro Sitzung.

OutBufCountClient

Die Anzahl der Ausgabepuffer auf dem Client.

OutBufLength

Die Länge der Ausgabepuffer in Byte.

DeviceId[MAX_PATH + 1]

Die Geräte-ID des Netzwerkadapters.

Bemerkungen

Für das ClientAddressFamily Member gibt AF_INET (IPv4) im Zeichenfolgenformat zurück, z. B. "127.0.0.1". AF_INET6 (IPv6) wird in binärer Form zurückgegeben.

Anmerkung

Der wtsapi32.h-Header definiert WTSCLIENT als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista mit SP1
mindestens unterstützte Server-	Windows Server 2008
Header-	wtsapi32.h