Поделиться через

Структура WTSCLIENTA (wtsapi32.h)

  • Статья

Содержит сведения о клиенте подключения к удаленному рабочему столу (RDC).

Синтаксис

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;

Члены

ClientName[CLIENTNAME_LENGTH + 1]

NetBIOS-имя клиентского компьютера.

Domain[DOMAIN_LENGTH + 1]

Доменное имя клиентского компьютера.

UserName[USERNAME_LENGTH + 1]

Имя пользователя клиента.

WorkDirectory[MAX_PATH + 1]

Папка для начальной программы.

InitialProgram[MAX_PATH + 1]

Программа, запускаемая при подключении.

EncryptionLevel

Уровень безопасности шифрования.

ClientAddressFamily

Семейство адресов. Это может быть AF_INET, AF_INET6, AF_IPX, AF_NETBIOS или AF_UNSPEC.

ClientAddress[CLIENTADDRESS_LENGTH + 1]

Сетевой адрес клиента.

HRes

Горизонтальное измерение (в пикселях) клиентского дисплея.

VRes

Вертикальное измерение (в пикселях) дисплея клиента.

ColorDepth

Глубина цвета отображения клиента. Возможные значения см. в элементе ColorDepth структуры WTS_CLIENT_DISPLAY .

ClientDirectory[MAX_PATH + 1]

Расположение библиотеки DLL клиентского элемента ActiveX.

ClientBuildNumber

Номер сборки клиента.

ClientHardwareId

Зарезервировано.

ClientProductId

Зарезервировано.

OutBufCountHost

Количество выходных буферов на сервере за сеанс.

OutBufCountClient

Количество выходных буферов на клиенте.

OutBufLength

Длина выходных буферов в байтах.

DeviceId[MAX_PATH + 1]

Идентификатор устройства сетевого адаптера.

Комментарии

Для члена ClientAddressFamilyAF_INET (IPv4) возвращается в формате строки, например 127.0.0.1. AF_INET6 (IPv6) возвращается в двоичной форме.

Примечание

Заголовок wtsapi32.h определяет WTSCLIENT как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista с пакетом обновления 1 (SP1)
Минимальная версия сервера Windows Server 2008
Верхняя часть wtsapi32.h