ITSGAuthenticationEngine::AuthenticateUser メソッド (tsgauthenticationengine.h)

ユーザーを認証します。

リモート デスクトップ ゲートウェイ (RD ゲートウェイ) は、新しい接続要求を受信したときにこのメソッドを呼び出します。 認証プラグインは、 cookieData パラメーターによって参照される Cookie に基づいてユーザーを認証する必要があります。 認証プラグインでは、 ITSGAuthenticateUserSink インターフェイスを使用して、認証の結果について RD ゲートウェイに通知する必要があります。

構文

HRESULT AuthenticateUser(
  [in] GUID                     mainSessionId,
  [in] BYTE                     *cookieData,
  [in] ULONG                    numCookieBytes,
  [in] ULONG_PTR                context,
  [in] ITSGAuthenticateUserSink *pSink
);

パラメーター

[in] mainSessionId

RD ゲートウェイによって接続要求に割り当てられた一意の識別子。

[in] cookieData

ユーザーによって提供される Cookie を含む BYTE へのポインター。

[in] numCookieBytes

cookieData パラメーターによって参照されるバイト数。

[in] context

この接続に固有の値を含む ULONG へのポインター。 この値は、 ITSGAuthenticateUserSink インターフェイスのメソッドを使用して RD ゲートウェイに渡す必要があります。

[in] pSink

認証プラグインが認証の結果を RD ゲートウェイに通知するために使用する必要がある ITSGAuthenticateUserSink インターフェイスへのポインター。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドが S_OKを返す場合、RD ゲートウェイは認証プラグインが ITSGAuthenticateUserSink インターフェイスのメソッドを呼び出すのを待機します。 その他の値が返された場合、RD ゲートウェイは接続要求を直ちに拒否します。

AuthenticateUser メソッドを使用するサンプルについては、リモート デスクトップ ゲートウェイのプラグ可能な認証と承認のサンプルを参照してください。

要件

サポートされている最小のクライアント	Windows 7
サポートされている最小のサーバー	Windows Server 2008 R2
対象プラットフォーム	Windows
ヘッダー	tsgauthenticationengine.h

関連項目

ITSGAuthenticationEngine