WRDS_CONNECTION_SETTINGS_1 结构 (wtsdefs.h)
包含远程会话的连接设置信息。
语法
typedef struct _WRDS_CONNECTION_SETTINGS_1 {
BOOLEAN fInheritInitialProgram;
BOOLEAN fInheritColorDepth;
BOOLEAN fHideTitleBar;
BOOLEAN fInheritAutoLogon;
BOOLEAN fMaximizeShell;
BOOLEAN fDisablePNP;
BOOLEAN fPasswordIsScPin;
BOOLEAN fPromptForPassword;
BOOLEAN fDisableCpm;
BOOLEAN fDisableCdm;
BOOLEAN fDisableCcm;
BOOLEAN fDisableLPT;
BOOLEAN fDisableClip;
BOOLEAN fResetBroken;
BOOLEAN fDisableEncryption;
BOOLEAN fDisableAutoReconnect;
BOOLEAN fDisableCtrlAltDel;
BOOLEAN fDoubleClickDetect;
BOOLEAN fEnableWindowsKey;
BOOLEAN fUsingSavedCreds;
BOOLEAN fMouse;
BOOLEAN fNoAudioPlayback;
BOOLEAN fRemoteConsoleAudio;
BYTE EncryptionLevel;
USHORT ColorDepth;
USHORT ProtocolType;
USHORT HRes;
USHORT VRes;
USHORT ClientProductId;
USHORT OutBufCountHost;
USHORT OutBufCountClient;
USHORT OutBufLength;
ULONG KeyboardLayout;
ULONG MaxConnectionTime;
ULONG MaxDisconnectionTime;
ULONG MaxIdleTime;
ULONG PerformanceFlags;
ULONG KeyboardType;
ULONG KeyboardSubType;
ULONG KeyboardFunctionKey;
ULONG ActiveInputLocale;
ULONG SerialNumber;
ULONG ClientAddressFamily;
ULONG ClientBuildNumber;
ULONG ClientSessionId;
WCHAR WorkDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1];
WCHAR UserName[WTS_USERNAME_LENGTH + 1];
WCHAR Domain[WTS_DOMAIN_LENGTH + 1];
WCHAR Password[WTS_PASSWORD_LENGTH + 1];
WCHAR ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1];
WCHAR DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1];
WCHAR imeFileName[WTS_IMEFILENAME_LENGTH + 1];
WCHAR AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1];
WCHAR ClientName[WTS_CLIENTNAME_LENGTH + 1];
WCHAR ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1];
WCHAR ClientDirectory[WTS_DIRECTORY_LENGTH + 1];
WCHAR ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1];
WRDS_SOCKADDR ClientSockAddress;
WRDS_TIME_ZONE_INFORMATION ClientTimeZone;
WRDS_LISTENER_SETTINGS WRdsListenerSettings;
GUID EventLogActivityId;
#if ...
ULONG ContextSize;
#if ...
PBYTE ContextData;
#else
ULONG ContextSize;
#endif
#else
PBYTE ContextData;
#endif
} WRDS_CONNECTION_SETTINGS_1, *PWRDS_CONNECTION_SETTINGS_1;
成员
fInheritInitialProgram
指定是否继承在远程桌面服务 shell 中启动的初始程序。 此值覆盖 fInheritInitialProgram 侦听器注册表值。
fInheritColorDepth
指定是否继承监视器颜色深度。 此值覆盖 fInheritColorDepth 侦听器注册表值。
fHideTitleBar
指定标题栏是否隐藏。
fInheritAutoLogon
指定登录过程是否自动。 此值覆盖 fInheritAutoLogon 侦听器注册表值。
fMaximizeShell
指定初始程序是否最大化显示。 如果 fInheritInitialProgram 设置为 TRUE，则使用此值。
fDisablePNP
指定是否启用 PNP 重定向。 此值最初是从策略信息设置的。 如果重置值，则会覆盖该策略。
fPasswordIsScPin
指定在登录过程中使用了智能卡。 智能卡 PIN 是密码。 如果 fInheritAutoLogon 设置为 TRUE，则使用此值。
fPromptForPassword
指定是否提示用户输入密码。 如果此值为 TRUE，则即使 fInheritAutoLogon 注册表值为 TRUE 且未设置“始终请求密码”策略，也会提示用户。
fDisableCpm
指定是否启用打印机映射。 此值最初是从策略信息设置的。 如果重置值，则会覆盖该策略。
fDisableCdm
指定是否启用驱动器映射。 此值最初是从策略信息设置的。 如果重置值，则会覆盖该策略。
fDisableCcm
指定是否启用 COM 端口映射。 此值最初是从策略信息设置的。 如果重置值，则会覆盖该策略。
fDisableLPT
指定是否启用 LPT 打印机重定向。 此值最初是从策略信息设置的。 如果重置值，则会覆盖该策略。
fDisableClip
指定是否启用剪贴板重定向。 此值最初是从策略信息设置的。 如果重置值，则会覆盖该策略。
fResetBroken
指定在连接或空闲计时器过期或连接因连接错误而丢失时服务器采取的操作。
FALSE
会话已断开连接，但它保留在服务器上。
TRUE
会话终止。
fDisableEncryption
指定是否为客户端和服务器之间的通信禁用加密。
fDisableAutoReconnect
指定是否禁用客户端的自动重新连接。
fDisableCtrlAltDel
指定是否禁用 Ctrl+Alt+Delete 键盘快捷方式。
fDoubleClickDetect
指定客户端是否可以双击。
fEnableWindowsKey
指定是否启用 Windows 密钥。
fUsingSavedCreds
指定客户端在登录过程中是否使用保存的凭据。
fMouse
指定是否启用鼠标输入。
fNoAudioPlayback
指定是否打开音频播放。 如果值为 TRUE ，则不指定音频。
fRemoteConsoleAudio
指定是否在远程计算机上保留音频播放。
EncryptionLevel
指定加密级别。
ColorDepth
指定客户端监视器颜色深度。 有关可能的值，请参阅 WTS_CLIENT_DISPLAY 结构的 ColorDepth 成员。
ProtocolType
指定协议类型。
HRes
指定客户端监视器的水平分辨率。
VRes
指定客户端监视器垂直分辨率。
ClientProductId
客户端软件产品 ID。
OutBufCountHost
主机上的输出缓冲区数。
OutBufCountClient
客户端上的输出缓冲区数。
OutBufLength
输出缓冲区的长度（以字节为单位）。
KeyboardLayout
指定键盘布局。
MaxConnectionTime
远程桌面服务会话的最长持续时间（以分钟为单位）。
MaxDisconnectionTime
断开连接的远程桌面服务会话在 RD 会话主机服务器上保持活动状态的最长时间（以分钟为单位）。
MaxIdleTime
远程桌面服务会话可以保持空闲的最长时间（以分钟为单位）。
PerformanceFlags
指定可在服务器上设置以提高性能的一组功能。 这可以是以下一个或多个值的组合。
WRDS_PERF_DISABLE_NOTHING (0x00000000)
未禁用任何功能。
WRDS_PERF_DISABLE_WALLPAPER (0x00000001)
桌面上的壁纸不显示。
WRDS_PERF_DISABLE_FULLWINDOWDRAG (0x00000002)
已禁用全屏拖动;移动窗口时，仅显示窗口轮廓。
WRDS_PERF_DISABLE_MENUANIMATIONS (0x00000004)
禁用菜单动画。
WRDS_PERF_DISABLE_THEMING (0x00000008)
主题处于禁用状态。
WRDS_PERF_ENABLE_ENHANCED_GRAPHICS (0x00000010)
启用增强型图形。
WRDS_PERF_DISABLE_CURSOR_SHADOW (0x00000020)
光标不显示阴影。
WRDS_PERF_DISABLE_CURSORSETTINGS (0x00000040)
光标闪烁已禁用。
WRDS_PERF_ENABLE_FONT_SMOOTHING (0x00000080)
启用字体平滑。
WRDS_PERF_ENABLE_DESKTOP_COMPOSITION (0x00000100)
启用桌面组合。
KeyboardType
指定键盘类型。
KeyboardSubType
指定键盘子类型。
KeyboardFunctionKey
指定函数键。
ActiveInputLocale
指定输入区域设置标识符。 低字包含语言标识符，高字包含键盘物理布局的设备句柄。
SerialNumber
客户端计算机的唯一序列号。
ClientAddressFamily
客户端 IP 地址系列。
ClientBuildNumber
客户端内部版本号。
ClientSessionId
客户端会话 ID。
WorkDirectory[WTS_DIRECTORY_LENGTH + 1]
一个字符串，其中包含初始程序所在的目录。 如果 fInheritInitialProgram 设置为 TRUE，则使用此值。
InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1]
一个字符串值，该值指定初始程序的名称。 如果 fInheritInitialProgram 设置为 TRUE，则使用此值。
UserName[WTS_USERNAME_LENGTH + 1]
一个指定用户名的字符串。 如果 fInheritAutoLogon 设置为 TRUE，则使用此值。
Domain[WTS_DOMAIN_LENGTH + 1]
一个指定用户域的字符串。 如果 fInheritAutoLogon 设置为 TRUE，则使用此值。
Password[WTS_PASSWORD_LENGTH + 1]
一个指定用户密码的字符串。 如果 fInheritAutoLogon 设置为 TRUE，则使用此值。
ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1]
包含协议名称的字符串。
DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1]
一个字符串，指定要加载的显示驱动程序的名称。
DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1]
一个指定显示设备名称的字符串。
imeFileName[WTS_IMEFILENAME_LENGTH + 1]
指定输入法编辑器名称。
AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1]
包含要加载的音频驱动程序的名称的字符串。
ClientName[WTS_CLIENTNAME_LENGTH + 1]
包含客户端计算机的完全限定名称的字符串。
ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1]
一个字符串，包含点状十进制格式的客户端 IP 地址。
ClientDirectory[WTS_DIRECTORY_LENGTH + 1]
客户端目录。
包含客户端目录的字符串。
ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1]
包含客户端产品标识符的字符串。
ClientSockAddress
包含套接字地址信息的 WRDS_SOCKADDR 结构。
ClientTimeZone
包含客户端时区信息的 WRDS_TIME_ZONE_INFORMATION 结构。
WRdsListenerSettings
包含侦听器设置 的WRDS_LISTENER_SETTINGS 结构。
EventLogActivityId
ContextSize
ContextData 数组的大小（以字节为单位）。
ContextData
包含连接的上下文数据的字节数组。 此数组的大小在 ContextSize 成员中指定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2012 |
| 标头 | wtsdefs.h (包括 Wtsprotocol.h) |