IMsRdpExtendedSettings::Property プロパティ
名前付きプロパティを含みます。
このプロパティは読み取り/書き込み可能です。
構文
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 の場合、リモート資格情報ガードが有効になります。 |
| 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 の場合、リモート セッションは、GDI へのフォールバックなしで DirectX のみを使用して表示されます。 このプロパティは、リモート アプリ セッションには適用されません。 注: DirectX 専用モードが唯一使用可能なオプションになる可能性があるため、このプロパティは今後のバージョンの Windows で削除される可能性があります。 これは現在、運用コードで有効にするべきではないプレビュー機能です。 |
| GatewayCertificateLogonAuthority | VT_BSTR | W | なし | このプロパティはサポートされていません。 今後のバージョンの Windows では削除される可能性があります。 このプロパティは使用しないでください。 |
| EnableRemoteEdgeBar | VT_BOOL | R/W | なし | True で ServerSupportsEdgeActions プロパティがTrue の場合、リモート セッションの接続ツール バーに追加のコマンドが表示されます。 |
| TSGTransportIsUsed | VT_BOOL | R | なし | True の場合、関連付けられているリモート セッションにリモート デスクトップ ゲートウェイが使用されます。 |
| DiagnosticsInfo | VT_BSTR | W | なし | クライアント X.224 接続要求 PDU の rdpCorrelationInfo.correlationId フィールドを表す 16 進数の文字列。 |
| EndpointFedAuth | VT_BSTR | W | なし | 要求ベースのフェデレーション RDSTLS 認証に使用されるトークン。 |
| AllowAxToContainerEvents | VT_BOOL | W | なし | このプロパティは、Windows 11 22H2 で追加されました。
|
| ServerSupportsEdgeActions | VT_BOOL | R | なし | リモート セッションに 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::StartWorkspaceEx2 に渡される AppContainer ID。 注: 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 の場合、リモート セッションでは、最大 4 つのペン デバイスからの入力の同時挿入がサポートされます。 既定では、これは False に設定されています。 |
| ShowGatewayInformation | VT_BOOL | W | はい | このプロパティに True を書き込むには、リモート デスクトップ ゲートウェイに関する情報を示すダイアログが表示されます。 Windows 11 22H2 以降: このプロパティはサポートされなくなり、ShowConnectionInformation プロパティに置き換えられました。 |
必要条件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント |
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 として定義されます |