共用方式為

IMsRdpExtended設定：:P roperty 屬性

  • 發行項

包含具名屬性。

這是可讀寫的屬性。

語法

HRESULT put_Property(
  [in]          BSTR    bstrPropertyName,
  [in]          VARIANT *pValue
);

HRESULT get_Property(
  [in]          BSTR    bstrPropertyName,
  [out, retval] VARIANT *pValue
);

屬性值

具名屬性值。

屬性名稱 資料類型 存取權限 可以在連線啟動後變更 描述
連線ToChildSession VT_BOOL 讀取/寫入 Yes 將此屬性設定為 True 會導致用戶端控制項連線到本機電腦上的子會話，而不是遠端伺服器。 如果此屬性設定為 true ，則您無法連線到遠端伺服器，因為所有連線都會重新導向至 localhost。 如需子會話的詳細資訊，請參閱 子會話 。
DisableCredentialsDelegation VT_BOOL 讀取/寫入 No 如果 為 True ，則不會將認證傳送至遠端伺服器。
EnableFrameBufferRedirection VT_BOOL 讀取/寫入 No 如果 為 True ，則會嘗試框架緩衝區重新導向。 針對回送連線（同一部電腦同時為用戶端和伺服器）框架緩衝區重新導向，允許在會話之間共用框架緩衝區的記憶體。
EnableHardwareMode VT_BOOL 僅寫入 No 如果 為 True ，則會嘗試使用硬體協助進行圖形解碼。
IgnoreCursors VT_BOOL 僅寫入 No 如果 為 True ，則會忽略遠端伺服器所傳送的資料指標。
ManualClipboardSyncEnabled VT_BOOL 讀取/寫入 Yes 將此屬性設定為 True 表示本機和遠端剪貼簿不會自動保持同步。相反地， IMsRdpClipboard 介面必須用來將剪貼簿格式從本機剪貼簿同步至遠端剪貼簿，以及將遠端剪貼簿同步至本機剪貼簿。
ZoomLevel *VT_UI4 讀取/寫入 Yes 使用 RDP ActiveX 控制項實作 Zoom 功能。 [縮放] 功能可從 RDP 的 [系統 ] 功能表取得。 ZoomLevel 屬性在 RemoteApp 模式和全螢幕模式中沒有作用。 IMsRdpClientAdvanced設定：：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 ， 則會啟用遠端認證防護 。 
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 會話。
應該提供下列屬性：
  • WslgSharedMemoryPath
  • HvSocketEnabled
  • HvSocketServiceId

請參閱 WSLg 的檔 https://github.com/microsoft/wslg 。
ShowSessionDiagnostics VT_BOOL W 是的 將 True 寫入 此屬性會立即顯示對話方塊，其中包含遠端會話的詳細資訊。
這個屬性是偵錯機制。 它可能會變更和移除。 
PrintingProgressMode VT_UI4 R/W 不 可能的值：
  • 0：列印停用時顯示的進度對話方塊
  • 1：列印時顯示的進度對話方塊包含基本資訊
  • 2：列印時顯示的進度對話方塊包含詳細資訊
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 不 十六進位字串， 代表用戶端 X.224 連線ion 要求 PDU 的 rdpCorrelationInfo.correlationId 欄位。 
EndpointFedAuth VT_BSTR W 不 用於宣告型同盟 RDSTLS 驗證 的 權杖。 
AllowAxToContainerEvents VT_BOOL W 不 此屬性已在 Windows 11 22H2 中新增。
  • 如果 為 False （從 Windows 11 22H2 開始的預設行為），CTRL+ALT+方向鍵組合會傳送至遠端會話。
  • 如果 為 True （Windows 11 22H2 之前的預設行為），CTRL+ALT+ARROW 鍵組合會將 IMsTscAxEvents：：OnFocusReleased 事件引發至應用程式。
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：：StartWorkspaceExtension 時 ，傳遞至 IWorkspaceScriptable3：：StartWorkspaceExtension 的 AppContainer 識別碼 。
注意：RemoteApp 和 Desktop 連線ions 控制台已不再處於使用中開發狀態。 未來版本的 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 中 連線的唯一 識別碼，連線遠端會話所屬。 
Show連線ionInformation VT_BOOL W 是的 將 True 寫入 此屬性會顯示 [連線ion 資訊] 對話方塊。 
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 和更新版本：已不再支援此屬性，且已由 Show連線ionInformation 屬性取代。

需求

需求 值
最低支援的用戶端
 Windows 8
最低支援的伺服器
 Windows Server 2012
類型程式庫
MsTscAx.dll
DLL
MsTscAx.dll
CLSID
 CLSID_MsRdpClient7Not保管庫ForScripting 定義為 54d38bf7-b1ef-4479-9674-1bd6ea465258
CLSID_MsRdpClient8Not保管庫ForScripting 定義為 A3BC03A0-041D-42E3-AD22-882B7865C9C5
CLSID_MsRdpClient9Not保管庫ForScripting 定義為 8B918B82-7985-4C24-89DF-C33AD2BBFBCD
IID
 IID_IMsRdpExtended設定定義為 302D8188-0052-4807-806A-362B628F9AC5

另請參閱

IMsRdpExtended設定