通过

WTS_INFO_CLASS枚举 （wtsapi32.h）

包含一个值，该值指示在调用 WTSQuerySessionInformation 函数时要检索的会话信息的类型。

Syntax

typedef enum _WTS_INFO_CLASS {
  WTSInitialProgram,
  WTSApplicationName,
  WTSWorkingDirectory,
  WTSOEMId,
  WTSSessionId,
  WTSUserName,
  WTSWinStationName,
  WTSDomainName,
  WTSConnectState,
  WTSClientBuildNumber,
  WTSClientName,
  WTSClientDirectory,
  WTSClientProductId,
  WTSClientHardwareId,
  WTSClientAddress,
  WTSClientDisplay,
  WTSClientProtocolType,
  WTSIdleTime,
  WTSLogonTime,
  WTSIncomingBytes,
  WTSOutgoingBytes,
  WTSIncomingFrames,
  WTSOutgoingFrames,
  WTSClientInfo,
  WTSSessionInfo,
  WTSSessionInfoEx,
  WTSConfigInfo,
  WTSValidationInfo,
  WTSSessionAddressV4,
  WTSIsRemoteSession,
  WTSSessionActivityId,
  WTSCapabilityCheck
} WTS_INFO_CLASS;

Constants

 
WTSInitialProgram
一个以 null 结尾的字符串，其中包含远程桌面服务在远程桌面服务运行时运行的初始程序的名称
用户登录。
WTSApplicationName
一个以 null 结尾的字符串，其中包含会话正在运行的应用程序的已发布名称。

Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista： 不支持此值
WTSWorkingDirectory
一个以 null 结尾的字符串，其中包含启动初始程序时使用的默认目录。
WTSOEMId
不使用此值。
WTSSessionId
包含会话标识符的 ULONG 值。
WTSUserName
一个以 null 结尾的字符串，其中包含与会话关联的用户的名称。
WTSWinStationName
包含远程桌面服务会话名称的以 null 结尾的字符串。

注意 尽管其名称，但指定此类型不会返回窗口工作站名称。 而是返回
远程桌面服务会话的名称。 每个远程桌面服务会话都与交互式窗口相关联
站。 因为交互式窗口工作站的唯一受支持的窗口站名称是
“WinSta0”，每个会话都与其自己的“WinSta0”窗口工作站相关联。 有关详细信息，请参阅
窗口工作站。

 
WTSDomainName
一个以 null 结尾的字符串，其中包含登录用户所属的域的名称。
WTSConnectState
会话的当前连接状态。 有关详细信息，请参阅
WTS_CONNECTSTATE_CLASS。
WTSClientBuildNumber
包含客户端内部版本号的 ULONG 值。
WTSClientName
包含客户端名称的以 null 结尾的字符串。
WTSClientDirectory
一个以 null 结尾的字符串，其中包含安装客户端的目录。
WTSClientProductId
特定于 USHORT 客户端的产品标识符。
WTSClientHardwareId
包含特定于客户端的硬件标识符的 ULONG 值。 此选项保留供将来使用。 WTSQuerySessionInformation 始终返回值 0。
WTSClientAddress
客户端的网络类型和网络地址。 有关详细信息，请参阅
WTS_CLIENT_ADDRESS。

IP 地址从WTS_CLIENT_ADDRESS的地址成员的开头偏移两个字节
结构。
WTSClientDisplay
有关客户端的显示分辨率的信息。 有关详细信息，请参阅
WTS_CLIENT_DISPLAY。
WTSClientProtocolType
一个 USHORT 值，该值指定有关 的协议类型的信息
会期。 这是以下值之一。


















价值Meaning

0


控制台会话。


1


此值保留为旧用途。


2


RDP 协议。
WTSIdleTime
此值返回 FALSE。 如果调用 GetLastError 以获取扩展的错误信息， GetLastError 将返回 ERROR_NOT_SUPPORTED。

若要对会话空闲时间进行分类，请使用 LastInputTime 结构字段。

Windows Server 2008 和 Windows Vista： 不使用此值。
WTSLogonTime
此值返回 FALSE。 如果调用 GetLastError 以获取扩展的错误信息， GetLastError 将返回 ERROR_NOT_SUPPORTED。

Windows Server 2008 和 Windows Vista： 不使用此值。
WTSIncomingBytes
此值返回 FALSE。 如果调用 GetLastError 以获取扩展的错误信息， GetLastError 将返回 ERROR_NOT_SUPPORTED。

Windows Server 2008 和 Windows Vista： 不使用此值。
WTSOutgoingBytes
此值返回 FALSE。 如果调用 GetLastError 以获取扩展的错误信息， GetLastError 将返回 ERROR_NOT_SUPPORTED。

Windows Server 2008 和 Windows Vista： 不使用此值。
WTSIncomingFrames
此值返回 FALSE。 如果调用 GetLastError 以获取扩展的错误信息， GetLastError 将返回 ERROR_NOT_SUPPORTED。

Windows Server 2008 和 Windows Vista： 不使用此值。
WTSOutgoingFrames
此值返回 FALSE。 如果调用 GetLastError 以获取扩展的错误信息， GetLastError 将返回 ERROR_NOT_SUPPORTED。

Windows Server 2008 和 Windows Vista： 不使用此值。
WTSClientInfo
有关远程桌面连接 （RDC） 客户端的信息。 有关详细信息，请参阅 WTSCLIENT。
WTSSessionInfo
有关 RD 会话主机服务器上的客户端会话的信息。 有关详细信息，请参阅 WTSINFO。
WTSSessionInfoEx
有关 RD 会话主机服务器上的会话的扩展信息。 有关详细信息，请参阅 WTSINFOEX。

Windows Server 2008 和 Windows Vista： 不支持此值。
WTSConfigInfo
包含有关 RD 会话主机服务器配置的信息的 WTSCONFIGINFO 结构。

Windows Server 2008 和 Windows Vista： 不支持此值。
WTSValidationInfo
不支持此值。
WTSSessionAddressV4
包含分配给会话的 IPv4 地址的 WTS_SESSION_ADDRESS 结构。
如果会话没有虚拟 IP 地址， WTSQuerySessionInformation 函数将返回 ERROR_NOT_SUPPORTED。

Windows Server 2008 和 Windows Vista： 不支持此值。
WTSIsRemoteSession
确定当前会话是否为远程会话。 WTSQuerySessionInformation 函数返回 TRUE 值，指示当前会话是远程会话，如果为 FALSE，则指示当前会话是本地会话。 此值只能用于本地计算机，因此 WTSQuerySessionInformation 函数的 hServer 参数必须包含WTS_CURRENT_SERVER_HANDLE。

Windows Server 2008 和 Windows Vista： 不支持此值。
WTSSessionActivityId
包含当前与会话关联的终端服务活动 ID 的 GUID 值。

Windows Server 2025 或 Windows 11 之前的版本（23H2）： 不支持此值。
WTSCapabilityCheck
与会话主机是否支持某些功能对应的 UINT32 值的数组 。

如果列表包含该值 59083637 ，则表示支持 RAIL 协议 v2。

Windows Server 2025 或 Windows 11 之前的版本（24H2）： 不支持此值。

要求

Requirement 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2008
Header wtsapi32.h

另请参阅

WTSQuerySessionInformation

  • Last updated on