EapPeerQueryInteractiveUIInputFields 函数 (eapmethodpeerapis.h)

EapPeerQueryInteractiveUIInputFields 函数定义 EAP 方法 API 的实现,该 API 为要在请求方上引发的交互式 UI 组件提供输入字段。

语法

DWORD EapPeerQueryInteractiveUIInputFields(
  [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 的指针,表示为指向字段数据的内部指针。 请求者从 EAPHost 运行时 API 获取了这些内部指针。

[out] pEapInteractiveUIData

接收 EAP_INTERACTIVE_UI_DATA 结构的指针,该结构包含 EAP 请求方上引发的交互式 UI 组件的配置信息。

[out] ppEapError

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

[in, out] ppvReserved

保留以供将来使用。 必须设置为 NULL

返回值

备注

EapPeerQueryInteractiveUIInputFields 可用于支持单一登录 (SSO) 。 EapPeerBeginSession 中的EAP_FLAG_PRE_LOGON标志向 EAPHost 指示应提供 SSO。 如果在调用 EapPeerBeginSession 后收到 EapPeerResponseInvokeUI 操作代码,则 EAPHost 会调用 EapPeerQueryInteractiveUIInputFields,稍后调用 EapPeerQueryUIBlobFromInteractiveUIInputFields

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

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 eapmethodpeerapis.h

另请参阅

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO 和 PLAP