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。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | eapmethodpeerapis.h |