EapHostPeerQueryInteractiveUIInputFields 函数 (eaphostpeerconfigapis.h)

EapHostPeerQueryInteractiveUIInputFields 函数获取将在请求方上引发的交互式 UI 组件的输入字段。

语法

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

参数

[in] dwVersion

API 的版本号。

[in] dwFlags

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

[in] dwSizeofUIContextData

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

[in] pUIContextData

指向包含 UI 上下文数据的 BLOB 的指针，表示为指向字段数据的内部指针。 必须通过将这些内部指针传递给 EapHostPeerFreeMemory（从最内部的指针开始）来释放这些内部指针。

[out] pEapInteractiveUIData

接收 EAP_INTERACTIVE_UI_DATA 结构的指针，该结构包含 EAP 请求方上引发的交互式 UI 组件的配置信息。 调用方应使用 EapHostPeerFreeMemory 函数释放内部指针，从最内层指针开始。

[out] ppEapError

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

[in, out] ppvReserved

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

返回值

无

备注

EapHostPeerQueryInteractiveUIInputFields 可用于支持单一登录 (SSO) 。 请求方使用 EapHostPeerBeginSession 中的 EAP_FLAG_PRE_LOGON 标志向 EAPHost 指示应提供 SSO。 如果在调用 EapHostPeerBeginSession 后收到 EapHostPeerResponseInvokeUI 操作代码，则 EAPHost 会调用 EapHostPeerQueryInteractiveUIInputFields，稍后调用 EapHostPeerQueryUIBlobFromInteractiveUIInputFields。

请求方应调用返回 EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED ，请求方应通过调用 EapHostPeerInvokeInteractiveUI 来使用调用方法交互式 UI 的传统模型。 如果出现错误， EapHostPeerQueryInteractiveUIInputFields 将返回 NULL 以外的返回代码。

要求

另请参阅

EAPHost 请求配置函数

SSO 和 PLAP