Structure WTSCLIENTA (wtsapi32.h)

Contient des informations sur un client RDC (Remote Desktop Connection).

Syntaxe

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;

Membres

ClientName[CLIENTNAME_LENGTH + 1]

Nom NetBIOS de l’ordinateur client.

Domain[DOMAIN_LENGTH + 1]

Nom de domaine de l’ordinateur client.

UserName[USERNAME_LENGTH + 1]

Nom d’utilisateur du client.

WorkDirectory[MAX_PATH + 1]

Dossier du programme initial.

InitialProgram[MAX_PATH + 1]

Programme à démarrer sur la connexion.

EncryptionLevel

Niveau de sécurité du chiffrement.

ClientAddressFamily

Famille d’adresses. Ce membre peut être AF_INET, AF_INET6, AF_IPX, AF_NETBIOSou AF_UNSPEC.

ClientAddress[CLIENTADDRESS_LENGTH + 1]

Adresse réseau du client.

HRes

Dimension horizontale, en pixels, de l’affichage du client.

VRes

Dimension verticale, en pixels, de l’affichage du client.

ColorDepth

Profondeur de couleur de l’affichage du client. Pour connaître les valeurs possibles, consultez le membre ColorDepth de la structure WTS_CLIENT_DISPLAY.

ClientDirectory[MAX_PATH + 1]

Emplacement de la DLL de contrôle ActiveX client.

ClientBuildNumber

Numéro de build du client.

ClientHardwareId

Réservé.

ClientProductId

Réservé.

OutBufCountHost

Nombre de mémoires tampons de sortie sur le serveur par session.

OutBufCountClient

Nombre de mémoires tampons de sortie sur le client.

OutBufLength

Longueur des mémoires tampons de sortie, en octets.

DeviceId[MAX_PATH + 1]

ID de l’appareil de la carte réseau.

Remarques

Pour le membre ClientAddressFamily, AF_INET (IPv4) retourne au format de chaîne, par exemple « 127.0.0.1 ». AF_INET6 (IPv6) retourne sous forme binaire.

Note

L’en-tête wtsapi32.h définit WTSCLIENT comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista avec SP1
serveur minimum pris en charge	Windows Server 2008
d’en-tête	wtsapi32.h