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 控制件實作 Zoom 功能。 [縮放] 功能可從 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 | 不 | 指定要從用戶端重新導向至遠端會話之音訊擷取裝置的裝置標識碼。 應用程式可以使用 DRV_QUERYFUNCTIONINSTANCEID 訊息來判斷要重新導向之音訊擷取裝置的裝置標識碼。 或者，這可以設定為 「default」，以使用預設裝置或 「none」 來停用音訊擷取。 根據預設，這會設定為 「default」。 |
| RailMode | VT_BOOL | R | 不 | 報告這是否為 RemoteApp 連線。 ITSRemoteProgram：：RemoteProgramMode 寫入此屬性。 |
| EnableRdsAadAuth | VT_BOOL | W | 不 | 如果 True，則會使用 RDS AAD 驗證安全性。 |
| RDGIsKDCProxy | VT_BOOL | W | 不 | 如果 True，則告訴用戶端使用 RD 閘道（如果指定的話），做為 KDC Proxy 伺服器。 |
| UseURCP | VT_BOOL | R/W | 不 | 如果 True，這個屬性會啟用 UDP 型遠端桌面連線的通用速率控制通訊協定。 目前預設會停用它。 如果建議使用 UDP，請啟用它。 |
| DesktopScaleFactor | VT_UI4 | R/W | 不 | 指定遠端會話中使用的 裝置縮放比例。 此值應介於 100 到 500 之間（百分比）。 |
| RedirectedAuthentication | VT_BOOL | W | 不 | 如果 True，則會啟用遠端 Credential Guard 。 |
| RestrictedLogon | VT_BOOL | W | 不 | 如果 True，則會啟用 受限制的管理模式。 |
| AudioPlaybackDevice | VT_BSTR | R/W | 不 | 指定本機電腦上音訊播放裝置的裝置識別碼。 應用程式可以使用 DRV_QUERYFUNCTIONINSTANCEID 訊息來判斷要重新導向之音訊播放裝置的裝置標識碼。 “或者，這可以設定為 ”“default”，以使用默認裝置或 “none” 來停用音訊播放。 根據預設，這會設定為 “”default“。 " |
| SelectedMonitors | VT_BSTR | R/W | 不 | 以逗號分隔或以半數據行分隔的監視器標識符清單，用來識別要顯示遠端會話的選取監視器。 清單中的第一個標識符會被視為遠程會話中的主要監視器。 |
| 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。 此屬性不適用於遠端應用程式會話。 注意：此屬性可能會在未來版本的 Windows 中移除，因為 DirectX 專用模式可能成為唯一可用的選項。 這是目前不應在生產程式代碼中啟用的預覽功能。 |
| GatewayCertificateLogonAuthority | VT_BSTR | W | 不 | 不再支援這個屬性。 在未來版本的 Windows 中，可能會移除它。 請勿使用這個屬性。 |
| EnableRemoteEdgeBar | VT_BOOL | R/W | 不 | 如果 True，且 ServerSupportsEdgeActions 屬性 True，則會在遠端會話的連接工具列中顯示其他命令。 |
| TSGTransportIsUsed | VT_BOOL | R | N/A | 如果 True，則遠端桌面閘道會用於相關聯的遠端工作階段。 |
| DiagnosticsInfo | VT_BSTR | W | 不 | 十六進位字串，代表 Client 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，則同步顯示組態時，會將擴充監視資訊 （例如 EDIDs） 傳送至遠端會話。 |
| 工作區標識碼 | VT_BSTR | W | 不 | RemoteApp 和 Desktop Connections 中連線的唯一標識符， 遠端會話所屬。 |
| ShowConnectionInformation | VT_BOOL | W | 是的 | 將 True 寫入此屬性會顯示 [連線資訊] 對話框。 |
| WslgSharedMemoryPath | VT_BSTR | W | 不 | 要與 WSLg 虛擬機共用圖形緩衝區的記憶體會話對象路徑。 |
| HiDefRemoteAppContainerGUID | VT_BSTR | W | 不 | 與裝載遠端應用程式之執行中 VM 相關聯的 GUID。 寫入此屬性會導致本機 VM 中執行的遠端應用程式因為記憶體共用而改善效能。 |
| KDCProxyName | VT_BSTR | W | 不 | 「指定金鑰發佈中心 （KDC） Proxy 伺服器的完整功能變數名稱。 KDC Proxy 可讓 RDP 用戶端在無法直接存取 KDC 時使用 Kerberos 驗證通訊協定。 屬性值的範例：「kdc.contoso.com」。。 如需詳細資訊，請參閱：設定 Kerberos 密鑰發佈中心 Proxy、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 裝置，使用者可以選擇透過從連線列的 USB 重新導向來重新導向它們（連線列中的裝置對話框）或 RDP 檔案專案 “UsbDevicesToRedirect”。 |
| 允許的安全性通訊協定 | VT_BSTR | W | 不 | 在 Windows 11 版本 24H2 中引進。 這個屬性可用來限制用戶端可以交涉的安全性通訊協定清單。 交涉通訊協議的實際清單是由其他組態設定和連線案例所決定，而且可能小於此屬性中指定的清單。 值必須包含以 『;』 分隔的通訊協定名稱清單，或值可以設定為 「」，這表示允許所有正常交涉的通訊協定。支援的通訊協定名稱包括：「TLS」、“CredSSP”、“RDSTLS” 和 “RDS AAD 驗證”預設值為 “”。 |
| 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 |