名前付きプロパティを格納します。
このプロパティは読み取り/書き込みです。
構文
HRESULT put_Property(
[in] BSTR bstrPropertyName,
[in] VARIANT *pValue
);
HRESULT get_Property(
[in] BSTR bstrPropertyName,
[out, retval] VARIANT *pValue
);
プロパティ値
名前付きプロパティ値。
| プロパティ名 | データ型 | アクセス | 接続開始後に変更可能 | 形容 |
|---|---|---|---|---|
| ConnectToChildSession | VT_BOOL | 読み取り/書き込み | はい | このプロパティを True に設定すると、クライアント コントロールはリモート サーバーではなくローカル コンピューター上の子セッションに接続します。 このプロパティが true |
| 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 の System メニューから使用できます。 ZoomLevel プロパティは、RemoteApp モードおよび全画面表示モードでは無効です。 IMsRdpClientAdvancedSettings::SmartSizing と ZoomLevel は相互に排他的です。 |
| DisableSeamlessLanguageBar | VT_BOOL | R/W | いいえ | true |
| RedirectTextProcessing | VT_BOOL | W | いいえ | Windows 11 23H2 以降では、テキスト処理のリダイレクトを有効または無効にします。これにより、テキスト入力シナリオ (IME、絵文字など) に対して同様のローカル エクスペリエンスが提供されます。 |
| HvSocketServiceId | VT_BSTR | W | いいえ | Hyper-V ソケットの ServiceId フィールドRDP トラフィックが送信されるアドレスを指定します。 |
| 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 |
| RDGIsKDCProxy | VT_BOOL | W | いいえ | true |
| UseURCP | VT_BOOL | R/W | いいえ | true |
| 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 のドキュメント 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 専用モードが唯一使用可能なオプションになる可能性があるため、このプロパティは今後のバージョンの Windows で削除される可能性があります。 これは現在、運用コードで有効にしてはならないプレビュー機能です。 |
| GatewayCertificateLogonAuthority | VT_BSTR | W | いいえ | このプロパティはサポートされなくなりました。 今後のバージョンの Windows では削除される可能性があります。 このプロパティは使用しないでください。 |
| EnableRemoteEdgeBar | VT_BOOL | R/W | いいえ | |
| TSGTransportIsUsed | VT_BOOL | R | N/A | 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 | N/A | リモート セッションに https://learn.microsoft.com/openspecs/windows_protocols/ms-rdpbcgr/379a020e-9925-4b4f-98f3-7d634e10b411 機能があるかどうかを判断する読み取り専用プロパティです。 |
| AppContainerID | VT_BSTR | W | いいえ | IMsRdpClientNonScriptable8::StartWorkspaceExtension が呼び出されたときに、 注: RemoteApp とデスクトップ接続のコントロール パネルは、アクティブな開発ではなくなりました。 将来のバージョンの Windows では、変更または使用できない可能性があります。 この API の使用はお勧めしません。 |
| IgnoreServerGeneratedMouseMoves | VT_BOOL | R/W | いいえ | true |
| RDmiDiagnosticsUrl | VT_BSTR | W | いいえ | このプロパティはサポートされなくなりました。 今後のバージョンの Windows では削除される可能性があります。 このプロパティは使用しないでください。 |
| EnableVailMonitorConfig | VT_BOOL | R/W | いいえ | true |
| ワークスペース 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 |
| HvSocketEnabled | VT_BOOL | W | いいえ | true ソケットのアドレス Hyper-V 詳細については、「Hyper-V ソケット |
| MultipenRemotingSupported | VT_BOOL | W | いいえ | true |
| ShowGatewayInformation | VT_BOOL | W | はい | このプロパティ True を書き込むには、リモート デスクトップ ゲートウェイに関する情報を示すダイアログが表示されます。 Windows 11 22H2 以降: このプロパティはサポートされなくなり、ShowConnectionInformation プロパティに置き換えられました。 |
| DisableAutoReconnectComponent | VT_BOOL | W | いいえ | true |
| RedirectUsbDrive | VT_UI4 | R/W | いいえ | Windows 11 バージョン 24H2 で導入されました。 0 に設定されていない場合、USB サム ドライブはドライブの方向としてリダイレクトされます。 1 に設定すると、すべての USB サム ドライブが USB デバイスとして自動的にリダイレクトされます。 2 に設定すると、USB サム ドライブが USB デバイスとして表示されます。ユーザーは、UI (接続バーのデバイス ダイアログ) または RDP ファイル エントリ "UsbDevicesToRedirect" から USB リダイレクトを使用してリダイレクトすることを選択できます。 |
| 許可されているセキュリティ プロトコル | 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 で導入されました。 このプロパティに True を書き込むと、カーソルが RemoteApp ウィンドウを離れると、マウスの移動が強制的に挿入されます。 これは、ツールヒントのバグの回避策を意図しています。 |
| FrameBufferRedirectionPresenter | IUnknown | W | いいえ | Windows 11 バージョン 24H2 で導入されました。 フレーム バッファーが変更されたときに、フレーム バッファーを表す生バイトを要求します。 IRdsFbrPresenter を参照してください |
| CursorRedirector | IUnknown | W | いいえ | Windows 11 バージョン 24H2 で導入されました。 リモート セッションが変更されたときに、リモート セッションを表すカーソル イメージへのハンドルを取得します。 IRdsCursorRedirector を参照してください |
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント |
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 として定義されています |