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

客户端显示器的颜色深度。 有关可能的值，请参阅 WTS_CLIENT_DISPLAY 结构的 ColorDepth 成员。

ClientDirectory[MAX_PATH + 1]

客户端 ActiveX 控件 DLL 的位置。

ClientBuildNumber

客户端内部版本号。

ClientHardwareId

保留。

ClientProductId

保留。

OutBufCountHost

服务器上每个会话的输出缓冲区数。

OutBufCountClient

客户端上的输出缓冲区数。

OutBufLength

输出缓冲区的长度（以字节为单位）。

DeviceId[MAX_PATH + 1]

网络适配器的设备 ID。

注解

对于 ClientAddressFamily 成员， AF_INET (IPv4) 将以字符串格式返回，例如“127.0.0.1”。 AF_INET6 (IPv6) 将以二进制形式返回。

注意

wtsapi32.h 标头将 WTSCLIENT 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows Vista SP1
最低受支持的服务器	Windows Server 2008
标头	wtsapi32.h