IMsRdpClientNonScriptable8::StartWorkspaceExtension メソッド
RemoteApp コントロール パネルとデスクトップ接続コントロール パネルを使用して、クライアントのリモート セッションを調整します。
注意
RemoteApp とデスクトップ接続のコントロール パネルは、アクティブな開発ではなくなりました。 将来のバージョンの Windows では、変更または使用できない可能性があります。 この API の使用はお勧めしません。
構文
HRESULT StartWorkspaceExtension(
[in] VARIANT_BOOL isWebHosted,
[in] BSTR workspaceId,
[in] BYTE *publisherThumbPrint,
[in] UINT publisherThumbPrintLength
);
パラメーター
isWebHosted
接続が Web サイトからホストされているかどうかを示す値。
workspaceId
RemoteApp コントロール パネルとデスクトップ接続コントロール パネルの接続の ID を含む文字列。
publisherThumbPrint
IWorkspaceScriptable3::StartWorkspaceEx2 に bstrWorkspaceParams として渡すバイナリ形式の拇印を表すバイト配列。 「解説」を参照してください。
publisherThumbPrintLength
publisherThumbPrint が指すバイト数。
戻り値
成功 した場合はS_OK を返します。
解説
この関数は、次のシナリオを処理します。
- リモート セッションとの接続時:
- ユーザーに資格情報の入力を求めた後、IWorkspaceScriptable3::StartWorkspaceEx2 を介して RemoteApp とデスクトップ接続コントロール パネルの接続に関連付けます。
- これは、IWorkspaceRegistration2::AddResourceEx を介してリモート セッションの存在を RemoteApp コントロール パネルとデスクトップ接続コントロール パネルに通知します。
- リモート セッションからの切断時:
- リモート セッションが IWorkspaceScriptable2::ResourceDismissed を介して無視されたことをユーザーに警告します
- これは、IWorkspaceRegistration2::RemoveResourceEx を介した切断の RemoteApp およびデスクトップ接続コントロール パネルに通知します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 11 バージョン 23H2 |
| タイプ ライブラリ | MsTscAx.dll |
| [DLL] | MsTscAx.dll |
| IID | IID_IMsRdpClientNonScriptable8は、B2B3FA47-3F11-4148-AD24-DFF8684A16D0 として定義されています |