Share via

EapHostPeerQueryUserBlobFromCredentialInputFields 関数 (eaphostpeerconfigapis.h)

  • [アーティクル]

EapHostPeerQueryUserBlobFromCredentialInputFields 関数は、シングル サインオン (SSO) UI から受信したユーザー入力から認証を開始するために使用できる資格情報 BLOB を取得します。

構文

DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      const BYTE                         *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [out]     EAP_ERROR                          **ppEapError
);

パラメーター

[in] hUserImpersonationToken

このセッションで使用するユーザー偽装トークンへのハンドル。

[in] eapMethodType

このセッションに使用する EAP 認証の種類を指定する EAP_METHOD_TYPE 構造体。

[in] dwFlags

EAP 認証セッションの動作を記述する EAP フラグ の組み合わせ。

[in] dwEapConnDataSize

pConnectionData で提供される接続データ バッファーのサイズ (バイト単位)。

[in] pbEapConnData

EAP メソッドに使用される接続データ。

[in] pEapConfigInputFieldArray

UI 入力フィールド データを含む EAP_CONFIG_INPUT_FIELD_ARRAY 構造体へのポインター。 呼び出し元は、最も内側のポインターから始まる関数 EapHostPeerFreeMemory を使用して内部ポインターを解放する必要があります。

[in, out] pdwUserBlobSize

ppbUserBlob が指すバッファーのサイズをバイト単位で指定する DWORD へのポインター。 この値が 0 に設定されていない場合は、このパラメーターで指定されたサイズのバッファーへのポインターを ppbUserBlob に指定する必要があります。

[in, out] ppbUserBlob

認証で使用できる資格情報 BLOB へのポインター。 EapHostPeerFreeMemory を呼び出してメモリを解放する必要があります。 このパラメーターに null 以外の値が指定されている場合 (既存のデータ BLOB が渡されることを意味します)、指定されたデータ BLOB が更新され、このパラメーターで返されます。 NULL 以外の BLOB 値を指定する場合は、 LocalAlloc 関数を使用する必要があります。

[out] ppEapError

この関数呼び出しの実行中に EAPHost によって発生したエラーを含む EAP_ERROR 構造体へのポインターへのポインター。 エラー データを使用した後、 EapHostPeerFreeErrorMemory を呼び出してこのメモリを解放する必要があります。

戻り値

なし

解説

EapHostPeerQueryUserBlobFromCredentialInputFields では SSO がサポートされています。 このサプリカント関数 ( EapHostPeerQueryCredentialInputFields など) は、SSO シナリオでのみ使用されます。

EapHostPeerQueryUserBlobFromCredentialInputFields の後、EAPHost は EapHostPeerBeginSession を呼び出します。 サプリカントは EapHostPeerBeginSession のEAP_FLAG_PRE_LOGON フラグを使用して、EAPHost が SSO を提供する必要があることを示します。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー eaphostpeerconfigapis.h
Library Eappcfg.lib
[DLL] Eappcfg.dll

関連項目

EAPHost サプリカント構成関数

SSO と PLAP