ホーム › System.RemoteDesktop › IWorkspace3
IWorkspace3
COM公式ドキュメント
RemoteApp とデスクトップ接続における接続に関する情報を提供するメソッドを公開し、さらに要求トークン(claims token)を取得または設定する機能を追加します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 7 HRESULT GetClaimsToken2(LPWSTR bstrClaimsHint, LPWSTR bstrUserHint, DWORD claimCookie, DWORD hwndCredUiParent, RECT rectCredUiParent, LPWSTR* pbstrAccessToken)
要求トークン(claims token)を取得します。
| bstrClaimsHint | LPWSTR | in | 要求ヒント(claims hint)を含む文字列。 |
| bstrUserHint | LPWSTR | in | ユーザーヒントを含む文字列。 |
| claimCookie | DWORD | in | 要求 Cookie。 |
| hwndCredUiParent | DWORD | in | 要求元となった親 UI 要素のハンドル。 |
| rectCredUiParent | RECT | in | 親 UI の X 座標および Y 座標を含む RECT 構造体へのポインター。 |
| pbstrAccessToken | LPWSTR* | out | 成功した場合、アクセストークンを含む文字列へのポインターを返します。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
vtbl 8 HRESULT SetClaimsToken(LPWSTR bstrAccessToken, ULONGLONG ullAccessTokenExpiration, LPWSTR bstrRefreshToken)
要求トークン(claims token)を設定します。
| bstrAccessToken | LPWSTR | in | アクセストークンを含む文字列。 |
| ullAccessTokenExpiration | ULONGLONG | in | アクセストークンが期限切れになるまでの時間(ミリ秒単位)。 |
| bstrRefreshToken | LPWSTR | in | 更新トークン(refresh token)を含む文字列。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IWorkspace3 "{1BECBE4A-D654-423B-AFEB-BE8D532C13C6}" #usecom global IWorkspace3 IID_IWorkspace3 "{4F1DFCA6-3AAD-48E1-8406-4BC21A501D7C}" #comfunc global IWorkspace3_GetClaimsToken2 7 wstr,wstr,int,int,int,var #comfunc global IWorkspace3_SetClaimsToken 8 wstr,int64,wstr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IWorkspace3 "{1BECBE4A-D654-423B-AFEB-BE8D532C13C6}" #usecom global IWorkspace3 IID_IWorkspace3 "{4F1DFCA6-3AAD-48E1-8406-4BC21A501D7C}" #comfunc global IWorkspace3_GetClaimsToken2 7 wstr,wstr,int,int,int,sptr #comfunc global IWorkspace3_SetClaimsToken 8 wstr,int64,wstr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。