IRDPSRAPISessionProperties::p ut_Property メソッド (rdpencomapi.h)
名前付きセッション プロパティを設定または取得します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT put_Property(
BSTR PropertyName,
VARIANT newVal
);
パラメーター
PropertyName
newVal
戻り値
なし
解説
次のプロパティを設定して取得できます。 プロパティ名では大文字と小文字が区別されます。
| プロパティ名 | プロパティの説明 | 値の型 |
|---|---|---|
| "DrvConAttach" |
メモDrvConAttach プロパティは、Windows 10の時点では使用できなくなりました。 共有用のミラー ドライバーがなくなりました。
2 番目のモードは静的読み込みモードです。 このモードでは、ミラー ドライバーはセッションが開かれた直後に読み込まれ、セッションが終了するまでアンロードされません。 どちらのモードでも、画面解像度の変更や色深度の共有などの外部イベントの結果として、ドライバーがデタッチされ、再アタッチされる可能性があることに注意してください。 このプロパティを動的添付モードの場合は VARIANT_TRUE に、静的添付ファイル モードの場合は VARIANT_FALSE に設定します。 このプロパティは、 IRDPSRAPISharingSession::Open メソッドを呼び出す前にのみ設定できることに注意してください。このプロパティは、 Open メソッドが呼び出された後に読み取り専用になります。 既定値は VARIANT_TRUE です。 リモート アシスタンスなどの 1 対 1 のシナリオでは、セッションが開かれると専門家が接続するまでに非常に長い時間がかかる可能性があるため、動的読み込みモードを使用する必要があります。 1:M (マルチパーティ) のシナリオでは、静的読み込みモードを使用する必要があります。これは、ミラー ドライバーのアタッチとデタッチは非常に破壊的であり、正当な理由がない限り実行しないでください。 |
VT_BOOL |
| "PortId" | sharer からの受信接続のリスナー ポート。 このプロパティはビューアー側でも設定できますが、逆接続の場合に接続をリッスンする場合にのみ使用されます。 | VT_I4 |
| "PortProtocol" | sharer でリスナーを開始するプロトコル ファミリを指定します。 次のような値が考えられます。 | VT_I4 |
| "SetNetworkStream" |
IRDPSRAPITransportStream インターフェイスをサポートする IUnknown インターフェイスへのポインター。 このプロパティが設定されている場合、Connect メソッドはこのストリームを使用し、渡された接続文字列を無視します。
このプロパティはビューアー側でのみ有効です。 |
VT_UNKNOWN |
| "EnforceStrongEncryption" |
このプロパティの値が VARIANT_TRUE の場合、共有者はビューアーで Federal Information Processing Standard (FIPS) 140 準拠の暗号化を使用する必要があります。 既定値は VARIANT_FALSE です。
このプロパティは、 IRDPSRAPISharingSession::Open メソッドが呼び出された後に読み取り専用になります。 このプロパティは、そのメソッドを呼び出す前にのみ設定できます。 FIPS 140 コンプライアンスに対するビューアーのサポートは、Windows 10 バージョン 1709 に追加されました。 sharer は、Windows 10 バージョン 1709 より前のバージョンのビューアーから接続を拒否します。 このプロパティは、共有側でのみ有効です。 |
VT_BOOL |
| "FrameCaptureIntervalInMs" |
フレーム キャプチャ間隔を指定します。 既定では、フレーム キャプチャ間隔は 33 ミリ秒で、1 秒あたり 30 フレームに対応します。
このプロパティを使用して、パフォーマンスを最適化できます。 画面の更新を頻繁に行う必要がない場合は、キャプチャ間隔を増やすことができます。 たとえば、値が 400 ミリ秒の場合、1 秒あたり 2.5 フレームになります。 このプロパティは、共有側でのみ有効です。 |
VT_I4 |
| "DefaultAttendeeControlLevel" |
出席者の既定のコントロール レベルを指定します。 既定では、この値は CTRL_LEVEL_NONE (なし) です。 この値は、CTRL_LEVEL_VIEW (ビュー) に変更できます。
既定のコントロール レベルを対話型に設定することはできません。 このプロパティは、共有側でのみ有効です。 |
VT_I4 |
| "EnableClipboardRedirect" |
このプロパティの値が VARIANT_TRUE の場合、共有元とビューアーの間のクリップボードがアクティブになります。 既定値は VARIANT_FALSE です。
クリップボード共有を使用するには、セッションが対話型モードである必要があります。 クリップボードを共有できるのは 1 つの接続だけです。 最後に取得した入力コントロールがクリップボード共有を引き継ぐ接続。 以前の接続のクリップボード共有は自動的に無効になります。 このプロパティは、デスクトップ アプリでのみ使用できます。 このプロパティは、共有側でのみ有効です。 このプロパティは、Windows 10 バージョン 1511 以降で使用できます。 |
VT_BOOL |
| "SetClipboardRedirectCallback" |
sharer コンピューターからビューアーへのコピーが試行されるたびにコールバックを受け取る IRDPSRAPIClipboardUseEvents のインスタンスへの IUnknown ポインターを指定します。 このプロパティは、クリップボードの共有が有効になっている場合にのみ関連します。
このプロパティは、 IRDPSRAPISharingSession::Open メソッドが呼び出された後に読み取り専用になります。 このプロパティは、そのメソッドを呼び出す前にのみ設定できます。 このプロパティは、デスクトップ アプリでのみ使用できます。 このプロパティは、共有側でのみ有効です。 このプロパティは、Windows 10 バージョン 1511 以降で使用できます。 |
VT_UNKNOWN |
| "EnabledTransports" |
有効にするトランスポートを指定します。 値 3 は、TCP と UDP の両方をサポートします。 既定値は 1 で、TCP のみです。
IRDPSRAPISharingSession::Open メソッドが呼び出されると、このプロパティは読み取り専用になります。 このプロパティは、そのメソッドを呼び出す前にのみ設定できます。 このプロパティは、バージョン 1803 Windows 10 以降で使用できます。 このプロパティは、共有側でのみ有効です。 |
VT_I4 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rdpencomapi.h |
| [DLL] | RdpEncom.dll |