EapHostPeerQueryUserBlobFromCredentialInputFields 函数 (eaphostpeerconfigapis.h)
EapHostPeerQueryUserBlobFromCredentialInputFields 函数获取凭据 BLOB，该 BLOB 可用于从单一登录 (SSO) UI 接收的用户输入开始身份验证。
语法
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_METHOD_TYPE结构，指定要用于此会话的 EAP 身份验证类型。
[in] dwFlags
描述 EAP 身份验证会话行为的 EAP 标志的组合。
[in] dwEapConnDataSize
pConnectionData 中提供的连接数据缓冲区的大小（以字节为单位）。
[in] pbEapConnData
用于 EAP 方法的连接数据。
[in] pEapConfigInputFieldArray
指向 EAP_CONFIG_INPUT_FIELD_ARRAY 结构的指针，其中包含 UI 输入字段数据。 调用方应使用 EapHostPeerFreeMemory 函数释放内部指针，从最内层指针开始。
[in, out] pdwUserBlobSize
指向 DWORD 的指针，指定 ppbUserBlob 指向的缓冲区的大小（以字节为单位）。 如果此值未设置为零，则必须向 ppbUserBlob 提供指向此参数中指定的大小的缓冲区的指针。
[in, out] ppbUserBlob
指向可在身份验证中使用的凭据 BLOB 的指针。 必须通过调用 EapHostPeerFreeMemory 来释放内存。 如果为此参数提供了非 null 值 (这意味着) 将现有数据 BLOB 传递给它，则所提供的数据 BLOB 将更新并在此参数中返回。 如果提供了非 NULL BLOB 值，则应使用 LocalAlloc 函数。
[out] ppEapError
指向 指向EAP_ERROR 结构的指针的指针，该结构包含 EAPHost 在执行此函数调用期间引发的任何错误。 使用错误数据后，必须通过调用 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 |