Share via

EapHostPeerQueryCredentialInputFields 関数 (eaphostpeerconfigapis.h)

  • [アーティクル]

シングル サインオン (SSO) シナリオで認証を実行するために必要な資格情報の種類をユーザーが判断できるようにします。

構文

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

パラメーター

[in] hUserImpersonationToken

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

[in] eapMethodType

サプリカントが使用する EAP メソッドを識別するEAP_METHOD_TYPE構造体。

[in] dwFlags

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

[in] dwEapConnDataSize

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

[in] pbEapConnData

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

[out] pEapConfigInputFieldArray

インストールされている EAP メソッドの EAP_METHOD_INFO_ARRAY 構造体へのポインター。 呼び出し元は、最も内側のポインターから始まる関数 EapHostPeerFreeMemory を使用して内部ポインターを解放する必要があります。

[out] ppEapError

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

戻り値

なし

解説

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

EapHostPeerQueryCredentialInputFields は 、セッション中に UI に表示されるフィールドを取得します。 入力フィールドは、SSO UI でユーザーが入力したデータを表示するために取得されます。 返される EAP_CONFIG_INPUT_FIELD_ARRAY 構造体には、入力フィールドの表示方法の詳細が含まれています。

EapHostPeerQueryCredentialInputFields の後、EAPHost は EapHostPeerQueryUserBlobFromCredentialInputFields を呼び出します。

要件

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

関連項目

EAPHost サプリカント構成関数

SSO と PLAP