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_METHOD_TYPE结构，用于标识请求方要使用的 EAP 方法。

[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。

要求

请参阅

EAPHost Supplicant 配置函数

SSO 和 PLAP