WTS_INFO_CLASS 枚举 (wtsapi32.h)

  • 项目

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

语法

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
} WTS_INFO_CLASS;

常量

 
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的 Address 成员的开头偏移两个字节
结构。
WTSClientDisplay
有关客户端的显示分辨率的信息。 有关详细信息，请参阅
WTS_CLIENT_DISPLAY。
WTSClientProtocolType
一个 USHORT 值，该值指定有关 的协议类型的信息
会话。 这是以下值之一。


















值含义

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： 不支持此值。

要求

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

请参阅

WTSQuerySessionInformation