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。

注解

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

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

要求

另请参阅

WTSEnumerateSessionsEx

WTS_SESSION_INFO