Share via

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

请参阅

EAPHost 请求配置函数

SSO 和 PLAP