IMsRdpClientAdvancedSettings 接口
管理高级客户端设置。 派生自 IMsTscAdvancedSettings 接口。 此接口包括用于检索和设置远程桌面 ActiveX 控件的高级 (可选) 属性的方法。
若要获取此接口的实例，请使用 IMsTscAx：：AdvancedSettings 属性获取 IMsTscAdvancedSettings 接口指针。 然后在 IMsTscAdvancedSettings 指针上调用 QueryInterface，并将IID_IMsRdpClientAdvancedSettings传递到 QueryInterface。
成员
IMsRdpClientAdvancedSettings 接口继承自 IMsTscAdvancedSettings。 IMsRdpClientAdvancedSettings 也具有以下类型的成员：
属性
IMsRdpClientAdvancedSettings 接口具有这些属性。
| 属性 | 访问类型 | 说明 |
|---|---|---|
|
AcceleratorPassthrough |
读取/写入 |
指定是否应将键盘快捷键传递给服务器。 |
|
BitmapCacheSize |
读取/写入 |
用于每像素 8 位位图的位图缓存文件的大小（以千字节为单位）。 此属性的有效数值为 1 到 32（含 1 到 32）。 |
|
BitmapPersistence |
读取/写入 |
指定是否应使用永久性位图缓存。 持久缓存可以提高性能，但需要额外的磁盘空间。 |
|
BitmapVirtualCache16BppSize |
读取/写入 |
指定用于每像素 15 位和 16 位高色设置的永久性位图缓存文件的大小（以 MB 为单位）。 |
|
BitmapVirtualCache24BppSize |
读取/写入 |
指定要用于 24 位/像素高颜色设置的永久性位图缓存文件的大小（以 MB 为单位）。 |
|
BitmapVirtualCacheSize |
读取/写入 |
指定要用于每像素 8 位颜色的永久性位图缓存文件的大小（以 MB 为单位）。 此属性的有效数值为 1 到 32（含 1 到 32）。 请注意，所有虚拟缓存文件的最大大小为 128 MB。 相关属性包括 BitmapVirtualCache16BppSize 和 BitmapVirtualCache24BppSize 属性。 |
|
brushSupportLevel |
读取/写入 |
不支持此属性。 |
|
CachePersistenceActive |
读取/写入 |
指定是否应使用永久性位图缓存。 |
|
ClearTextPassword |
只写 |
指定用于连接的密码。 有关详细信息，请参阅 IMsTscNonScriptable 接口。 |
|
ConnectToServerConsole |
读取/写入 |
不支持此属性。 |
|
ConnectWithEndpoint |
只写 |
不支持此属性。 |
|
DedicatedTerminal |
读取/写入 |
不支持此属性。 |
|
DisableCtrlAltDel |
读取/写入 |
指定是否应显示 Winlogon 中的初始解释屏幕。 |
|
DisplayConnectionBar |
读取/写入 |
指定是否使用连接栏。 默认值为 VARIANT_TRUE，这将启用 属性。 |
|
DoubleClickDetect |
读取/写入 |
指定客户端是否标识服务器的双击。 |
|
EnableMouse |
读取/写入 |
不支持此属性。 |
|
EnableWindowsKey |
读取/写入 |
指定是否可以在远程会话中使用 Windows 密钥。 |
|
EncryptionEnabled |
读取/写入 |
不支持此属性。 无法禁用加密。 |
|
GrabFocusOnConnect |
读取/写入 |
指定客户端控件在连接时是否应具有焦点。 |
|
HotKeyAltEsc |
读取/写入 |
指定要添加到 ALT 的虚拟键代码，以确定 ALT+ESC 的热键替换。
VK_INSERT 为默认值，ALT+INSERT 作为生成的序列。 仅当 未启用 KeyboardHookMode 属性时，此属性才有效。 |
|
HotKeyAltShiftTab |
读取/写入 |
指定要添加到 Alt 的虚拟键代码，以确定 Alt+SHIFT+TAB 的热键替换。
VK_NEXT 为默认值，将 ALT+PAGE DOWN 作为生成的序列。 仅当 未启用 KeyboardHookMode 属性时，此属性才有效。 |
|
HotKeyAltSpace |
读取/写入 |
指定要添加到 Alt 的虚拟键代码，以确定 ALT+SPACE 的热键替换。
VK_DELETE 为默认值，ALT+DELETE 作为生成的序列。 仅当 未启用 KeyboardHookMode 属性时，此属性才有效。 |
|
HotKeyAltTab |
读取/写入 |
指定要添加到 Alt 的虚拟键代码，以确定 ALT+TAB 的热键替换。
VK_PRIOR 是默认值，ALT+PAGE UP 作为生成的序列。 仅当 未启用 KeyboardHookMode 属性时，此属性才有效。 |
|
HotKeyCtrlAltDel |
读取/写入 |
指定要添加到 CTRL+ALT 的虚拟键代码，以确定 CTRL+ALT+DELETE 的热键替换，也称为安全注意序列 (SAS) 。 VK_END为默认值。 请注意，即使启用了 KeyboardHookMode 属性，Ctrl+ALT+DELETE 也永远不会重定向到远程服务器;Ctrl+Alt+DELETE 是本地 SAS 序列。 |
|
HotKeyCtrlEsc |
读取/写入 |
指定要添加到 ALT 的虚拟键代码，以确定 CTRL+ESC 的热键替换。
VK_HOME 是默认值，Alt+HOME 作为生成的序列。 仅当 未启用 KeyboardHookMode 属性时，此属性才有效。 |
|
HotKeyFullScreen |
读取/写入 |
指定要添加到 CTRL+Alt 的虚拟键代码，以确定用于切换到全屏模式的热键替换。
VK_CANCEL 为默认值。 |
|
InputEventsAtOnce |
读取/写入 |
不支持此属性。 |
|
keepAliveInterval |
读取/写入 |
指定客户端向服务器发送保持连接消息的时间间隔（以毫秒为单位）。 属性的默认值为零，这会禁用保持连接消息。 此属性的最小有效值为 10，000，表示 10 秒。 请注意，指定是否允许客户端与服务器的持久连接组策略设置可以替代此属性设置。 |
|
KeyboardFunctionKey |
读取/写入 |
仅适用于Windows CE。 |
|
KeyboardSubType |
读取/写入 |
仅适用于Windows CE。 |
|
KeyboardType |
读取/写入 |
仅适用于Windows CE。 |
|
LoadBalanceInfo |
读取/写入 |
指定将放置在 RD 会话主机服务器协议连接序列中的 X.224 连接请求数据包中的负载均衡 Cookie。 |
|
maxEventCount |
读取/写入 |
不支持此属性。 |
|
MaximizeShell |
读取/写入 |
指定是否应最大化使用 StartProgram 属性启动的程序。 |
|
minInputSendInterval |
读取/写入 |
指定发送鼠标事件之间的最小间隔（以毫秒为单位）。 |
|
MinutesToIdleTimeout |
读取/写入 |
指定客户端在没有用户输入的情况下应保持连接的最大时间长度（以分钟为单位）。 如果指定的时间已过，控件将调用 IMsTscAxEvents：：OnIdleTimeoutNotification 方法。 |
|
NotifyTSPublicKey |
读取/写入 |
不支持此属性。 |
|
NumBitmapCaches |
读取/写入 |
不支持此属性。 |
|
orderDrawThreshold |
读取/写入 |
不支持此属性。 |
|
overallConnectionTimeout |
读取/写入 |
指定客户端控件等待连接完成的总时间长度（以秒为单位）。 此属性的最大有效值为 600，表示 10 分钟。 如果指定的时间在连接完成之前已过，则控件将断开连接并调用 IMsTscAxEvents：：OnDisconnected 方法。 相关属性是 singleConnectionTimeout。 |
|
PerformanceFlags |
读取/写入 |
指定可在服务器上设置以提高性能的一组功能。 |
|
PersistCacheDirectory |
只写 |
不支持此属性。 |
|
PinConnectionBar |
读取/写入 |
指定 UI 连接栏的状态。 将此属性设置为 VARIANT_TRUE 将状态设置为“已降低”，即对用户不可见且无法输入。
VARIANT_FALSE 将状态设置为“引发”并可供用户输入。 |
|
RdpdrClipCleanTempDirString |
读取/写入 |
不支持此属性。 |
|
RdpdrClipPasteInfoString |
读取/写入 |
不支持此属性。 |
|
RdpdrLocalPrintingDocName |
读取/写入 |
不支持此属性。 |
|
RDPPort |
读取/写入 |
指定连接端口。 默认值为 3389。 |
|
RedirectDrives |
读取/写入 |
指定是否允许重定向磁盘驱动器。 |
|
RedirectPorts |
读取/写入 |
指定是否允许本地端口重定向 (例如 COM 和 LPT) 。 |
|
RedirectPrinters |
读取/写入 |
指定是否允许重定向打印机。 |
|
RedirectSmartCards |
读取/写入 |
指定是否允许对智能卡进行重定向。 |
|
SasSequence |
读取/写入 |
指定客户端将用于访问服务器上的登录屏幕的安全访问序列。 |
|
ScaleBitmapCachesByBPP |
读取/写入 |
不支持此属性。 |
|
ShadowBitmap |
读取/写入 |
不支持此属性。 Windows Vista： 指定是否应使用阴影位图。 |
|
shutdownTimeout |
读取/写入 |
指定等待服务器响应断开连接请求的时间长度（以秒为单位）。 属性的默认值为 10。 属性的最大有效值为 600，表示 10 分钟。 如果服务器未在指定时间内答复，客户端控件将断开连接。 |
|
singleConnectionTimeout |
读取/写入 |
指定客户端控件等待与 IP 地址建立连接的最大时间长度（以秒为单位）。 在连接期间，控件可能会尝试连接到多个 IP 地址。 此属性的最大有效值为 600。 相关属性为 overallConnectionTimeout。 |
|
SmartSizing |
读取/写入 |
指定是否应缩放显示以适应控件的工作区。
VARIANT_TRUE 启用缩放。 请注意，启用 SmartSizing 属性时不会显示滚动条。 |
|
SmoothScroll |
读取/写入 |
不支持此属性。 |
|
TransportType |
读取/写入 |
指定客户端使用的传输类型。 远程桌面 ActiveX 控件不使用此属性。 |
|
WinCEFixedPalette |
读取/写入 |
仅适用于Windows CE。 |
备注
此接口已由以下接口扩展，每个新接口继承先前接口的所有方法和属性：
- IMsRdpClientAdvancedSettings2
- IMsRdpClientAdvancedSettings3
- IMsRdpClientAdvancedSettings4
- IMsRdpClientAdvancedSettings5
- IMsRdpClientAdvancedSettings6
- IMsRdpClientAdvancedSettings7
- IMsRdpClientAdvancedSettings8
除非另有说明，否则在连接控件时无法设置此属性。
有关远程桌面 Web 连接的详细信息，请参阅 远程桌面 Web 连接的要求。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 类型库 |
|
| DLL |
|
| IID |
IID_IMsRdpClientAdvancedSettings定义为 3c65b4ab-12b3-465b-acd4-b8dad3bff9e2 |