EapPeerQueryUIBlobFromInteractiveUIInputFields 函数 (eapmethodpeerapis.h)

EapPeerQueryUIBlobFromInteractiveUIInputFields 函数将用户信息转换为可供 EAPHost 运行时函数使用的用户 BLOB。

语法

DWORD EapPeerQueryUIBlobFromInteractiveUIInputFields(
  [in]      DWORD                         dwVersion,
  [in]      DWORD                         dwFlags,
  [in]      DWORD                         dwSizeofUIContextData,
  [in]      const BYTE                    *pUIContextData,
  [in]      const EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
  [out]     DWORD                         *pdwSizeOfDataFromInteractiveUI,
  [out]     BYTE                          **ppDataFromInteractiveUI,
  [out]     EAP_ERROR                     **ppEapError,
  [in, out] LPVOID                        *ppvReserved
);

参数

[in] dwVersion

API 的版本号。 必须设置为零。

[in] dwFlags

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

[in] dwSizeofUIContextData

pUIContextData 参数中上下文数据的大小（以字节为单位）。

[in] pUIContextData

指向包含 UI 上下文数据的 BLOB 的指针，表示为指向字段数据的内部指针。 请求者从 EAPHost 运行时函数获取这些内部指针。

[in] pEapInteractiveUIData

用于接收 EAP_INTERACTIVE_UI_DATA 结构的指针，该结构包含 EAP 请求方上引发的交互式用户界面组件的配置信息。

[out] pdwSizeOfDataFromInteractiveUI

指向 DWORD 的指针，该指针指定 ppDataFromInteractiveUI 参数指向的缓冲区的大小（以字节为单位）。 如果未将此值设置为 0，则必须在 ppDataFromInteractiveUI 参数中提供指向此参数中指定的大小的缓冲区的指针。

[out] ppDataFromInteractiveUI

一个指针，用于接收可用于身份验证的凭据 BLOB。 调用方应使用 EapPeerFreeMemory 函数释放内部指针，从最内部的指针开始。 如果为此参数提供了非 NULL 值，这意味着将现有数据 BLOB 传递给该参数，则所提供的数据 BLOB 将更新并在此参数中返回。

[out] ppEapError

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

[in, out] ppvReserved

保留供将来使用。 此参数必须设置为 0。

返回值

无

备注

对等方法 API 调用序列。

要求

另请参阅

EAPHost Supplicant 配置函数

SSO 和 PLAP