ホーム › System.RemoteDesktop › ITSGAuthorizeResourceSink
ITSGAuthorizeResourceSink
COM公式ドキュメント
リソースの承認試行の結果を Remote Desktop Gateway (RD Gateway) に通知するメソッドを公開します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT OnChannelAuthorized(HRESULT hrIn, GUID mainSessionId, INT subSessionId, LPWSTR* allowedResourceNames, DWORD numAllowedResourceNames, LPWSTR* failedResourceNames, DWORD numFailedResourceNames)
リソースの承認試行の結果を Remote Desktop Gateway (RD Gateway) に通知します。
| hrIn | HRESULT | in | 承認試行の結果です。試行が成功したことを示すには S_OK を指定します。試行が失敗したことを示すにはそれ以外の値を指定します。 |
| mainSessionId | GUID | in | RD Gateway によって接続要求に割り当てられた一意の識別子です。 |
| subSessionId | INT | in | RD Gateway によってサブセッションに割り当てられた一意の識別子です。サブセッションとは、別のセッションから起動されたセッションです。 |
| allowedResourceNames | LPWSTR* | in | 承認に成功したリソースの一覧を格納する BSTR へのポインターです。 |
| numAllowedResourceNames | DWORD | in | allowedResourceNames パラメーターが参照するリソースの数です。関数が成功する場合、このパラメーターは 1 以上でなければなりません。 |
| failedResourceNames | LPWSTR* | in | 承認に失敗したリソースの一覧を格納する BSTR へのポインターです。 |
| numFailedResourceNames | DWORD | in | failedResourceNames パラメーターが参照するリソースの数です。 |
戻り値
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
このメソッドは、 AuthorizeResource の実装内から呼び出すことができます。 承認に 1 秒を超える時間がかかる場合は、認証を実行するための別のスレッドを起動することをお勧めします。
OnChannelAuthorized メソッドを使用するサンプルについては、Remote Desktop Gateway Pluggable Authentication and Authorization サンプルを参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ITSGAuthorizeResourceSink "{FEDDFCD4-FA12-4435-AE55-7AD1A9779AF7}" #usecom global ITSGAuthorizeResourceSink IID_ITSGAuthorizeResourceSink "{}" #comfunc global ITSGAuthorizeResourceSink_OnChannelAuthorized 3 int,int,int,var,int,var,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_ITSGAuthorizeResourceSink "{FEDDFCD4-FA12-4435-AE55-7AD1A9779AF7}" #usecom global ITSGAuthorizeResourceSink IID_ITSGAuthorizeResourceSink "{}" #comfunc global ITSGAuthorizeResourceSink_OnChannelAuthorized 3 int,int,int,sptr,int,sptr,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。