Win32 API 日本語リファレンス
ホーム › System.RemoteDesktop › IWorkspace2

IWorkspace2

COM
📘 Microsoft Learn (日本語) · English
IID96d8d7cf-783e-4286-834c-ebc0e95f783c継承元IWorkspace自前メソッド開始 vtbl6

公式ドキュメント

RemoteApp とデスクトップ接続における接続に関する情報を提供する追加のメソッドを公開します。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 6 HRESULT StartRemoteApplicationEx(LPWSTR bstrWorkspaceId, LPWSTR bstrRequestingAppId, LPWSTR bstrRequestingAppFamilyName, VARIANT_BOOL bLaunchIntoImmersiveClient, LPWSTR bstrImmersiveClientActivationContext, SAFEARRAY* psaParams)

サポートされていません。(IWorkspace2.StartRemoteApplicationEx)

bstrWorkspaceIdLPWSTRinアプリケーションを起動する接続の ID を格納する文字列。
bstrRequestingAppIdLPWSTRinリモートデスクトップ上で起動するアプリケーションの ID を格納する文字列。
bstrRequestingAppFamilyNameLPWSTRin起動するアプリケーションのファミリ名を格納する文字列。
bLaunchIntoImmersiveClientVARIANT_BOOLinVARIANT_TRUE を指定すると、Web クライアント経由でアクセスされたかのように、最新のリモートデスクトッププロトコルを使用してリモートアプリケーションを起動します。VARIANT_FALSE を指定すると、従来のターミナルサーバー方式でリモートアプリケーションを起動します。
bstrImmersiveClientActivationContextLPWSTRin特定のリモートデスクトップクライアント用のコンテキストを格納する文字列。
psaParamsSAFEARRAY*in

ワークスペースランタイムに渡すパラメーターを格納する BSTR 値の配列へのポインター。

RDP 接続の場合、このパラメーターには 2 つの文字列が含まれます。

  • シリアル化された RDP ファイル
  • リモートデスクトップ接続クライアントのコマンドラインパラメーター

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

StartRemoteApplicationEx には多数の新機能が含まれます。リモートデスクトップの初回起動時にサードパーティ製アプリケーションを起動する機能、複数のリモートデスクトップを処理する機能、Web ベースのクライアント UI での起動などです。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IWorkspace2 "{96D8D7CF-783E-4286-834C-EBC0E95F783C}"
#usecom global IWorkspace2 IID_IWorkspace2 "{4F1DFCA6-3AAD-48E1-8406-4BC21A501D7C}"
#comfunc global IWorkspace2_StartRemoteApplicationEx  6 wstr,wstr,wstr,int,wstr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。