IMsRdpExtendedSettings：:P roperty 属性
包含命名属性。
此属性为读/写。
语法
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
属性值
命名属性值。
| 属性名称 | 数据类型 | 访问 | 可以在连接启动后更改 | 描述 |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | 读/写 | 是的 | 将此属性设置为 True 会导致客户端控件连接到本地计算机上的子会话，而不是远程服务器。 如果此属性设置为 true，则无法连接到远程服务器，因为所有连接都重定向到 localhost。 有关子会话的详细信息，请参阅 子会话。 |
| DisableCredentialsDelegation | VT_BOOL | 读/写 | 不 | 如果 True，则不会将凭据发送到远程服务器。 |
| EnableFrameBufferRedirection | VT_BOOL | 读/写 | 不 | 如果 True，则尝试帧缓冲区重定向。 对于环回连接（同一台计算机是客户端和服务器）帧缓冲区重定向，允许在会话之间共享帧缓冲区的内存。 |
| EnableHardwareMode | VT_BOOL | 仅写入 | 不 | 如果 True，则尝试使用硬件协助进行图形解码。 |
| IgnoreCursors | VT_BOOL | 仅写入 | 不 | 如果 True，则忽略远程服务器发送的游标。 |
| ManualClipboardSyncEnabled | VT_BOOL | 读/写 | 是的 | 将此属性设置为 True 意味着本地和远程剪贴板不会自动保持同步。相反，必须使用 IMsRdpClipboard 接口将剪贴板格式从本地剪贴板同步到远程剪贴板，将远程剪贴板同步到本地剪贴板。 |
| ZoomLevel | * VT_UI4 | 读/写 | 是的 | 使用 RDP ActiveX 控件实现缩放功能。 “缩放”功能可从 RDP 的 系统 菜单中获取。 ZoomLevel 属性在 RemoteApp 模式和全屏模式下不起作用。 IMsRdpClientAdvancedSettings：：SmartSizing 和 ZoomLevel 互斥。 |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | 不 | 如果 True，这会导致 RemoteApp 连接从 Windows 8 之前还原到旧版语言栏，而不是自动将本地语言同步到远程会话。 |
| RedirectTextProcessing | VT_BOOL | W | 不 | 从 Windows 11 23H2 开始，启用/禁用文本处理的重定向，为文本输入方案（例如 IME、表情符号）提供类似本地的体验。 |
| HvSocketServiceId | VT_BSTR | W | 不 | 指定要在其中发送 RDP 流量的 Hyper-V 套接字的 ServiceId 字段地址。 |
| DeviceScaleFactor | VT_UI4 | R/W | 不 | 指定远程会话中使用的 设备规模因子。 有效值：100、140、180 |
| EnableLocationRedirection | VT_BOOL | R/W | 不 | 启用/禁用本地计算机位置到远程会话的重定向。 |
| AudioCaptureDevice | VT_BSTR | R/W | 不 | 指定要从客户端重定向到远程会话的音频捕获设备的设备 ID。 应用程序可以使用 DRV_QUERYFUNCTIONINSTANCEID 消息来确定要重定向的音频捕获设备的设备 ID。 或者，这可以设置为“default”，以使用默认设备或“none”禁用音频捕获。 默认情况下，此值设置为“default”。 |
| RailMode | VT_BOOL | R | 不 | 报告此连接是否为 RemoteApp 连接。 ITSRemoteProgram：：RemoteProgramMode 写入此属性。 |
| EnableRdsAadAuth | VT_BOOL | W | 不 | 如果 True，则使用 RDS AAD 身份验证安全性。 |
| RDGIsKDCProxy | VT_BOOL | W | 不 | 如果 True，则告知客户端使用 RD 网关（如果指定）作为 KDC 代理服务器。 |
| UseURCP | VT_BOOL | R/W | 不 | 如果 True，则此属性为基于 UDP 的远程桌面连接启用通用速率控制协议。 目前，它默认处于禁用状态。 如果建议使用 UDP，则启用它。 |
| DesktopScaleFactor | VT_UI4 | R/W | 不 | 指定远程会话中使用的 设备规模因子。 该值应介于 100 和 500 之间（百分比）。 |
| RedirectedAuthentication | VT_BOOL | W | 不 | 如果 True，则启用 Remote Credential Guard。 |
| RestrictedLogon | VT_BOOL | W | 不 | 如果 True，则启用 受限管理模式。 |
| AudioPlaybackDevice | VT_BSTR | R/W | 不 | 指定本地计算机上的音频播放设备的设备 ID。 应用程序可以使用 DRV_QUERYFUNCTIONINSTANCEID 消息来确定要重定向的音频播放设备的设备 ID。 “或者，可以将其设置为”default“，以使用默认设备或”none“禁用音频播放。 默认情况下，此值设置为“default”。 " |
| SelectedMonitors | VT_BSTR | R/W | 不 | 以逗号分隔或以半列分隔的监视器 ID 列表，用于标识要在其中显示远程会话的选定监视器。 列表中的第一个 ID 将被视为远程会话中的主监视器。 |
| WslgModeEnabled | VT_BOOL | W | 不 | 如果 True，则会话为 WSLg 会话。 应提供以下属性：
请参阅 WSLg 的文档 https://github.com/microsoft/wslg。 |
| ShowSessionDiagnostics | VT_BOOL | W | 是的 | 将 True 写入此属性后，将立即显示一个对话框，其中包含有关远程会话的详细信息。 此属性旨在成为调试机制。 它可能会更改和删除。 |
| PrintingProgressMode | VT_UI4 | R/W | 不 | 可能的值：
|
| CorrelationId | VT_BOOL | W | 不 | 重写 IMsRdpClientNonScriptable8：：CorrelationId 返回的值。 |
| RequestUseNewOutputPresenter | VT_BOOL | W | 不 | 如果 True，则仅使用 DirectX 显示远程会话，而不回退到 GDI。 此属性不适用于远程应用会话。 注意：由于 DirectX 仅模式可能成为唯一可用的选项，因此，在 Windows 的未来版本中，此属性可能会删除。 这是目前不应在生产代码中启用的预览功能。 |
| GatewayCertificateLogonAuthority | VT_BSTR | W | 不 | 不再支持此属性。 在 Windows 的未来版本中，它可能会删除。 请勿使用此属性。 |
| EnableRemoteEdgeBar | VT_BOOL | R/W | 不 | 如果 True 且 ServerSupportsEdgeActions 属性 True，则远程会话的连接工具栏中会显示其他命令。 |
| TSGTransportIsUsed | VT_BOOL | R | N/A | 如果 True，则远程桌面网关将用于关联的远程会话。 |
| DiagnosticsInfo | VT_BSTR | W | 不 | 表示 客户端 X.224 连接请求 PDU的 rdpCorrelationInfo.correlationId 字段的十六进制字符串。 |
| EndpointFedAuth | VT_BSTR | W | 不 | 用于基于声明的联合 RDSTLS 身份验证的令牌。 |
| AllowAxToContainerEvents | VT_BOOL | W | 不 | 此属性已在 Windows 11 22H2 中添加。
|
| ServerSupportsEdgeActions | VT_BOOL | R | N/A | 只读属性，用于确定远程会话是否具有 RNS_UD_SC_EDGE_ACTIONS_SUPPORTED_V1 功能 https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411。 |
| AppContainerID | VT_BSTR | W | 不 | 调用 IMsRdpClientNonScriptable8：：StartWorkspaceEx2 注意：RemoteApp 和桌面连接控制面板不再处于活动开发阶段。 将来的 Windows 版本中可能会更改或不可用。 不建议使用此 API。 |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | 不 | 如果 True，则忽略以编程方式在远程会话中生成的鼠标移动。 更确切地说，不会应用指针位置更新 PDU。 请参阅 https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/3058381e-c856-4b26-a93c-d8f5514f8c3c。 |
| RDmiDiagnosticsUrl | VT_BSTR | W | 不 | 不再支持此属性。 在 Windows 的未来版本中，它可能会删除。 请勿使用此属性。 |
| EnableVailMonitorConfig | VT_BOOL | R/W | 不 | 如果 True，则同步显示配置时，扩展监视器信息（例如 EDID）将发送到远程会话。 |
| 工作区 ID | VT_BSTR | W | 不 | RemoteApp 和桌面连接中连接的唯一标识符 远程会话所属。 |
| ShowConnectionInformation | VT_BOOL | W | 是的 | 将 True 写入此属性将显示“连接信息”对话框。 |
| WslgSharedMemoryPath | VT_BSTR | W | 不 | 用于与 WSLg 虚拟机共享图形缓冲区的内存会话对象的路径。 |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | 不 | 与托管远程应用程序的正在运行的 VM 关联的 GUID。 由于内存共享，写入此属性可以提高在本地 VM 中运行的远程应用程序的性能。 |
| KDCProxyName | VT_BSTR | W | 不 | “指定密钥分发中心 （KDC） 代理服务器的完全限定域名。 KDC 代理允许 RDP 客户端在无法直接访问 KDC 时使用 Kerberos 身份验证协议。 属性值的示例：“”kdc.contoso.com”。 有关详细信息，请参阅：配置 Kerberos 密钥分发中心代理，https://learn.microsoft.com/openspecs/windows_protocols/MS-KKDCP/5bcebb8d-b747-4ee5-9453-428aec1c5c38 |
| DisableTouchRemoting | VT_BOOL | R/W | 不 | 如果 True，多触摸屏上的手势将不会发送到远程服务器。 默认情况下，此值设置为 False。 |
| HvSocketEnabled | VT_BOOL | W | 不 | 如果 True，远程服务器的名称（如果为 GUID），则解释为要在其中发送 RDP 流量的 Hyper-V 套接字地址的 VmId 字段。 默认情况下，此值设置为 False。 有关 Hyper-V 套接字地址的详细信息，请参阅 绑定到 Hyper-V 套接字。 |
| MultipenRemotingSupported | VT_BOOL | W | 不 | 如果 True，远程会话支持同时注入最多四个笔设备的输入。 默认情况下，此值设置为 False。 |
| ShowGatewayInformation | VT_BOOL | W | 是的 | 将 True 写入此属性会显示一个对话框，其中显示了有关远程桌面网关的信息。 Windows 11 22H2 及更高版本：此属性不再受支持，并且已替换为 ShowConnectionInformation 属性。 |
| DisableAutoReconnectComponent | VT_BOOL | W | 不 | 如果 True，则更改网络配置时，服务器连接不会断开连接并自动重新连接。 默认情况下，此值设置为 False。 |
| RedirectUsbDrive | VT_UI4 | R/W | 不 | 在 Windows 11 版本 24H2 中引入。 如果未设置或设置为 0，USB 拇指驱动器将重定向为驱动器方向。 设置为 1 时，所有 USB 指纹驱动器都会自动重定向为 USB 设备。 设置为 2 时，USB 指纹驱动器将列为 USB 设备，用户可以选择通过 UI（连接栏中的设备对话框）或 RDP 文件条目“UsbDevicesToRedirect”重定向来重定向它们。 |
| 允许的安全协议 | VT_BSTR | W | 不 | 在 Windows 11 版本 24H2 中引入。 此属性用于限制客户端可以协商的安全协议列表。 协商协议的实际列表由其他配置设置和连接方案确定，并且可能小于此属性中指定的列表。 该值必须包含由“;”分隔的协议名称列表，或者该值可以设置为“”，这意味着允许所有正常协商的协议。支持的协议名称为：“TLS”、“CredSSP”、“RDSTLS”和“RDS AAD Auth”默认值为“”。 |
| AllowRelativeMouseMode | VT_BOOL | R/W | 不 | 在 Windows 11 版本 24H2 中引入。 如果为 True，则表示相对于当前鼠标位置的鼠标移动。 |
| RemoteAppMouseMoveInject | VT_BOOL | W | 不 | 在 Windows 11 版本 24H2 中引入。 当光标离开 RemoteApp 窗口时，写入 True 会强制注入鼠标移动。 这是工具提示 bug 的解决方法。 |
要求
| 要求 | 价值 |
|---|---|
| 支持的最低客户端 |
Windows 8 |
| 支持的最低服务器 |
Windows Server 2012 |
| 类型库 |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient7NotSafeForScripting定义为 54d38bf7-b1ef-4479-9674-1bd6ea465258 CLSID_MsRdpClient8NotSafeForScripting定义为 A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9NotSafeForScripting定义为 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpExtendedSettings定义为 302D8188-0052-4807-806A-362B628F9AC5 |