EapPeerQueryUserBlobFromCredentialInputFields 函数 (eapmethodpeerapis.h)

EapPeerQueryUserBlobFromCredentialInputFields 函数定义 EAP 方法函数的实现，该函数获取在请求方引发的交互式单一登录 (SSO) UI 中提供的用户 BLOB 数据。

语法

DWORD EapPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      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_METHOD_TYPE 结构，其中包含有关用于对连接进行身份验证的 EAP 方法的供应商和作者信息。

[in] dwFlags

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

[in] dwEapConnDataSize

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

[in] pbEapConnData

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

[in] pEapConfigInputFieldArray

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

[in, out] pdwUserBlobSize

指向缓冲区的指针，该缓冲区包含 ppUserBlob 中不透明用户配置数据 BLOB 的大小（以字节为单位）。

[in, out] ppbUserBlob

包含不透明用户数据 BLOB 的指针。

[out] ppEapError

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

返回值

无

备注

EapPeerQueryUserBlobFromCredentialInputFields 支持单一登录 (SSO) 。 此对等方法函数（如 EapPeerQueryCredentialInputFields）仅在 SSO 方案中使用。

在 EapPeerQueryUserBlobFromCredentialInputFields 之后，EAPHost 调用 EapPeerBeginSession。 请求方使用 EapHostPeerBeginSession 中的 EAP_FLAG_PRE_LOGON 标志来指示 EAPHost 应提供 SSO。

要求

请参阅

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO 和 PLAP