通过

WTS_CONFIG_CLASS 枚举 (wtsapi32.h)

  • 项目

包含指示在调用 WTSQueryUserConfig 和 WTSSetUserConfig 函数时要设置或检索的用户配置信息类型的值。

语法

typedef enum _WTS_CONFIG_CLASS {
  WTSUserConfigInitialProgram,
  WTSUserConfigWorkingDirectory,
  WTSUserConfigfInheritInitialProgram,
  WTSUserConfigfAllowLogonTerminalServer,
  WTSUserConfigTimeoutSettingsConnections,
  WTSUserConfigTimeoutSettingsDisconnections,
  WTSUserConfigTimeoutSettingsIdle,
  WTSUserConfigfDeviceClientDrives,
  WTSUserConfigfDeviceClientPrinters,
  WTSUserConfigfDeviceClientDefaultPrinter,
  WTSUserConfigBrokenTimeoutSettings,
  WTSUserConfigReconnectSettings,
  WTSUserConfigModemCallbackSettings,
  WTSUserConfigModemCallbackPhoneNumber,
  WTSUserConfigShadowingSettings,
  WTSUserConfigTerminalServerProfilePath,
  WTSUserConfigTerminalServerHomeDir,
  WTSUserConfigTerminalServerHomeDirDrive,
  WTSUserConfigfTerminalServerRemoteHomeDir,
  WTSUserConfigUser
} WTS_CONFIG_CLASS;

常量

 
WTSUserConfigInitialProgram
一个以 null 结尾的字符串，其中包含远程桌面服务在 运行时运行的初始程序的路径
用户登录。

如果 WTSUserConfigfInheritInitialProgram 值为 1，则初始程序可以是
客户端指定的任何程序。
WTSUserConfigWorkingDirectory
一个以 null 结尾的字符串，包含初始程序的工作目录的路径。
WTSUserConfigfInheritInitialProgram
一个 值，该值指示客户端是否可以指定初始程序。














值含义

0


客户端无法指定初始程序。 而是
WTSUserConfigInitialProgram 字符串标识运行的初始程序
当用户登录到远程计算机时自动。 远程桌面服务在用户时注销用户
退出该程序。


1


客户端可以指定初始程序。
WTSUserConfigfAllowLogonTerminalServer
一个 值，该值指示是否允许用户帐户登录到 RD 会话主机服务器。














值含义

0


用户无法登录。


1


用户可以登录。
WTSUserConfigTimeoutSettingsConnections
一个 DWORD 值，该值指定最长连接持续时间（以毫秒为单位）。
在连接超时间隔到期前一分钟，系统会通知用户挂起的断开连接。
用户的会话已断开连接或终止，具体取决于
WTSUserConfigBrokenTimeoutSettings 值。 用户每次登录时，计时器为
重 置。 如果值为零，则表示连接计时器已禁用。
WTSUserConfigTimeoutSettingsDisconnections
一个 DWORD 值，该值指定的最大持续时间（以毫秒为单位）
RD 会话主机服务器在终止登录之前保留断开连接的会话。 值为零表示
断开连接计时器处于禁用状态。
WTSUserConfigTimeoutSettingsIdle
一个 DWORD 值，该值指定最长空闲时间（以毫秒为单位）。 如果有
指定间隔内没有键盘或鼠标活动，用户的会话已断开连接或终止
取决于 WTSUserConfigBrokenTimeoutSettings 值。 值为零
指示空闲计时器已禁用。
WTSUserConfigfDeviceClientDrives
远程桌面服务当前不使用此常量。

一个 值，该值指示 RD 会话主机服务器是否自动重新建立
登录时客户端驱动器映射。














值含义

0


服务器不会自动连接到以前映射的客户端驱动器。


1


服务器在登录时自动连接到以前映射的客户端驱动器。
WTSUserConfigfDeviceClientPrinters
RDP 5.0 及更高版本的客户端：指示 RD 会话主机服务器是否为一个值
登录时自动重新建立客户端打印机映射。














值含义

0


服务器不会自动连接到以前映射的客户端打印机。


1


服务器在登录时自动连接到以前映射的客户端打印机。
WTSUserConfigfDeviceClientDefaultPrinter
RDP 5.0 及更高版本的客户端：指示客户端打印机是否为的值
是默认打印机。














值含义

0


客户端打印机不是默认打印机。


1


客户端打印机是默认打印机。
WTSUserConfigBrokenTimeoutSettings
一个 值，该值指示连接或空闲计时器过期或连接丢失时会发生什么情况
由于连接错误。














值含义

0


会话已断开连接。


1


会话终止。
WTSUserConfigReconnectSettings
一个 值，该值指示如何为此用户重新连接断开连接的会话。














值含义

0


用户可以登录到任何客户端计算机以重新连接到断开连接的会话。


1


用户可以通过登录到用于建立的客户端计算机重新连接到断开连接的会话
断开连接的会话。 如果用户从其他客户端计算机登录，则用户将获得新的登录名
会话。
WTSUserConfigModemCallbackSettings
远程桌面服务当前不使用此常量。

一个 值，该值指示拨号连接的配置，其中
RD 会话主机服务器停止响应，然后回调客户端以建立连接。


















值含义

0


已禁用回调连接。


1


服务器提示用户输入电话号码，并拨打该电话号码回拨用户。 可以
使用 WTSUserConfigModemCallbackPhoneNumber 值指定默认手机
编号。


2


服务器自动拨打用户指定的电话号码
WTSUserConfigModemCallbackPhoneNumber 值。
WTSUserConfigModemCallbackPhoneNumber
远程桌面服务当前不使用此常量。

一个以 null 结尾的字符串，其中包含要用于回调的电话号码
。
WTSUserConfigShadowingSettings
RDP 5.0 及更高版本的客户端：指示用户是否会话的值
可以隐藏。 隐藏允许用户远程监视其他用户的屏幕操作。


























值含义

0


禁用


1


启用输入，通知


2


启用输入，不通知


3


启用无输入，通知


4


启用无输入、不通知
WTSUserConfigTerminalServerProfilePath
一个以 null 结尾的字符串，其中包含用于 RD 会话主机服务器登录的用户配置文件的路径。 目录
路径标识必须手动创建，并且必须在登录之前存在。
WTSSetUserConfig 不会创建目录
如果尚不存在，则为 。
WTSUserConfigTerminalServerHomeDir
一个以 null 结尾的字符串，其中包含用于 RD 会话主机服务器登录的用户根目录的路径。 此
string 可以指定本地路径或 UNC 路径 (\ComputerName\Share\Path) 。 有关详细信息，请参阅
WTSUserConfigfTerminalServerRemoteHomeDir。
WTSUserConfigTerminalServerHomeDirDrive
一个以 null 结尾的字符串，其中包含驱动器名称 (一个驱动器号，后跟一个冒号) UNC
映射 WTSUserConfigTerminalServerHomeDir 字符串中指定的路径。 有关详细信息，请参阅
WTSUserConfigfTerminalServerRemoteHomeDir。
WTSUserConfigfTerminalServerRemoteHomeDir
一个 值，该值指示 RD 会话主机服务器登录的用户根目录是本地路径还是
映射的驱动器号。 请注意，此值不能与
WTSSetUserConfig。














值含义

0


WTSUserConfigTerminalServerHomeDir 字符串包含 的本地路径
用户的 RD 会话主机服务器登录根目录。


1


WTSUserConfigTerminalServerHomeDir 字符串包含 的 UNC 路径
用户的 RD 会话主机服务器登录根目录和
WTSUserConfigTerminalServerHomeDirDrive 字符串包含一个驱动器号
映射 UNC 路径。
WTSUserConfigUser
包含会话的配置数据的 WTSUSERCONFIG 结构。

Windows Server 2008 和 Windows Vista： 不支持此值。

要求

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

另请参阅

WTSQueryUserConfig

WTSSetUserConfig