ホーム › System.RemoteDesktop › ITSGAuthorizeConnectionSink
ITSGAuthorizeConnectionSink
COM公式ドキュメント
接続の認可を試みた結果を Remote Desktop Gateway (RD Gateway) に通知するメソッドを公開します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT OnConnectionAuthorized(HRESULT hrIn, GUID mainSessionId, DWORD cbSoHResponse, BYTE* pbSoHResponse, DWORD idleTimeout, DWORD sessionTimeout, SESSION_TIMEOUT_ACTION_TYPE sessionTimeoutAction, AATrustClassID trustClass, DWORD* policyAttributes)
接続の認可を試みた結果を Remote Desktop Gateway (RD Gateway) に通知します。
| hrIn | HRESULT | in | 認可の試行結果。試行が成功したことを示すには S_OK を指定します。試行が失敗したことを示すにはその他の値を指定します。 |
| mainSessionId | GUID | in | RD Gateway が接続要求に割り当てた一意の識別子。 |
| cbSoHResponse | DWORD | in | pbSoHResponse パラメーターが参照するバイト数。 |
| pbSoHResponse | BYTE* | in | ステートメント オブ ヘルス (SoH) の要求に対する応答を指定する BYTE へのポインター。hrIn パラメーターが S_OK でない場合、このパラメーターは無視されます。 |
| idleTimeout | DWORD | in | 接続が切断されるまでにアイドル状態を維持できる分数。hrIn パラメーターが S_OK でない場合、このパラメーターは無視されます。 |
| sessionTimeout | DWORD | in | セッションに割り当てられる最大分数。hrIn パラメーターが S_OK でない場合、このパラメーターは無視されます。 |
| sessionTimeoutAction | SESSION_TIMEOUT_ACTION_TYPE | in | セッションがタイムアウトしたときに実行するアクション。hrIn パラメーターが S_OK でない場合、このパラメーターは無視されます。このパラメーターには次のいずれかの値を指定できます。 SESSION_TIMEOUT_ACTION_DISCONNECTセッションを切断します。 SESSION_TIMEOUT_ACTION_SILENT_REAUTHセッションを通知せずに再認証および再認可します。 |
| trustClass | AATrustClassID | in | このパラメーターは予約されています。常に AA_TRUSTEDUSER_TRUSTEDCLIENT を設定してください。hrIn パラメーターが S_OK でない場合、このパラメーターは無視されます。 |
| policyAttributes | DWORD* | in | 接続に関連付けられたリダイレクト設定を指定する Boolean 値の配列。配列の各要素は PolicyAttributeType 列挙体の値に対応します。hrIn パラメーターが S_OK でない場合、このパラメーターは無視されます。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。
解説(Remarks)
このメソッドは AuthorizeConnection の実装から呼び出すことができます。認証に 1 秒を超える時間がかかる場合は、認証を実行するために別のスレッドを起動することをお勧めします。
OnConnectionAuthorized メソッドを使用するサンプルについては、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_ITSGAuthorizeConnectionSink "{C27ECE33-7781-4318-98EF-1CF2DA7B7005}" #usecom global ITSGAuthorizeConnectionSink IID_ITSGAuthorizeConnectionSink "{}" #comfunc global ITSGAuthorizeConnectionSink_OnConnectionAuthorized 3 int,int,int,var,int,int,int,int,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_ITSGAuthorizeConnectionSink "{C27ECE33-7781-4318-98EF-1CF2DA7B7005}" #usecom global ITSGAuthorizeConnectionSink IID_ITSGAuthorizeConnectionSink "{}" #comfunc global ITSGAuthorizeConnectionSink_OnConnectionAuthorized 3 int,int,int,sptr,int,int,int,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。