EapPeerQueryCredentialInputFields 函数 (eapmethodpeerapis.h)

定义 EAP 方法特定函数的实现,该函数获取 EAP 方法的 EAP 单一登录 (SSO) 凭据输入字段。

语法

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

参数

[in] hUserImpersonationToken

要请求和获取其凭据的用户的模拟令牌。

[in] eapMethodType

一个 EAP_METHOD_TYPE 结构,其中包含有关用于对连接进行身份验证的 EAP 方法的供应商和作者信息。

[in] dwFlags

描述 EAP 身份验证会话行为的 EAP 标志的组合。

[in] dwEapConnDataSize

pbEapConnData 指向的 EAP SSO 配置字节数据的大小(以字节为单位)。

[in] pbEapConnData

指向包含 EAP 配置数据 BLOB 的不透明字节缓冲区的指针。

[out] pEapConfigFieldsArray

指向 EAP_CONFIG_INPUT_FIELD_ARRAY 结构的指针,该结构包含要显示给请求用户的输入字段。 单个EAP_CONFIG_INPUT_FIELD_DATA元素中的 pwszData 字段初始化为 NULL

[out] ppEapError

指向 EAP_ERROR 结构的地址的指针,该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后,必须通过将指向错误数据的指针传递给 EapPeerFreeErrorMemory 来释放此内存。

返回值

备注

EapPeerQueryCredentialInputFields 支持 SSO。 此对等方法函数(如 EapPeerQueryUserBlobFromCredentialInputFields)仅在 SSO 方案中使用。

每当请求方应用程序调用 EapHostPeerQueryCredentialInputFields 时,EAPHost 将调用此函数的 EAP 方法特定实现。 此函数的实施者负责确保此函数返回 的EAP_CONFIG_INPUT_FIELD_ARRAY 包含 EAP 方法将从请求方用户请求的每个凭据数据的输入字段定义。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 eapmethodpeerapis.h

另请参阅

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO 和 PLAP