WTS_SESSION_INFO_1A结构（wtsapi32.h）

包含有关远程桌面会话主机（RD 会话主机）服务器或远程桌面虚拟化主机（RD 虚拟化主机）服务器上的客户端会话的扩展信息。

语法

typedef struct _WTS_SESSION_INFO_1A {
  DWORD                  ExecEnvId;
  WTS_CONNECTSTATE_CLASS State;
  DWORD                  SessionId;
  LPSTR                  pSessionName;
  LPSTR                  pHostName;
  LPSTR                  pUserName;
  LPSTR                  pDomainName;
  LPSTR                  pFarmName;
} WTS_SESSION_INFO_1A, *PWTS_SESSION_INFO_1A;

成员

ExecEnvId

唯一标识 WTSEnumerateSessionsEx 函数返回的会话列表中的会话的标识符。 有关详细信息，请参阅“备注”。

State

指定远程桌面服务会话的连接状态的 WTS_CONNECTSTATE_CLASS 枚举类型的值。

SessionId

RD 会话主机服务器、RD 虚拟化主机服务器或虚拟机分配的会话标识符。

pSessionName

指向包含此会话名称的以 null 结尾的字符串的指针。 例如，“services”、“console”或“RDP-Tcp#0”。

pHostName

指向以 null 结尾的字符串的指针，该字符串包含运行会话的计算机的名称。 如果会话直接在 RD 会话主机服务器或 RD 虚拟化主机服务器上运行，则字符串包含 NULL。 如果会话在虚拟机上运行，则字符串包含虚拟机的名称。

pUserName

指向以 null 结尾的字符串的指针，该字符串包含登录到会话的用户的名称。 如果没有用户登录到会话，字符串将包含 NULL。

pDomainName

指向以 null 结尾的字符串的指针，该字符串包含登录到会话的用户的域名。 如果没有用户登录到会话，字符串将包含 NULL。

pFarmName

指向以 null 结尾的字符串的指针，该字符串包含虚拟机要联接到的场的名称。 如果会话未在已加入服务器场的虚拟机上运行，则字符串包含 NULL。

言论

WTSEnumerateSessionsEx 函数调用函数并指定通过调用 WTSOpenServerEx 函数获得的 RD 虚拟化主机服务器的句柄，则返回此结构。 在这种情况下，WTSEnumerateSessionsEx 函数聚合主机上运行的所有会话，以及单个虚拟机上运行的会话。 ExecEnvId 参数唯一标识聚合列表中的每个会话。 此标识符可能与托管会话的服务器或虚拟机中定义的实际会话标识符不同，该标识符由 SessionId 成员指定。

此结构所表示的会话可以是直接在服务器上运行的会话，也可以是虚拟机中运行的会话。 如果会话在虚拟机中运行，pHostName 成员包含虚拟机的名称。 pFarmName 成员适用于已加入 RD 会话主机场的虚拟机上托管的会话。

注意

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

要求

要求	价值
最低支持的客户端	Windows 7
支持的最低服务器	Windows Server 2008 R2
标头	wtsapi32.h

另请参阅

WTSEnumerateSessionsEx

WTS_SESSION_INFO