EapHostPeerInvokeInteractiveUI 函数 (eaphostpeerconfigapis.h)

  • 项目

引发用于从用户获取凭据的交互式用户界面。 例如，此函数可用于引发从智能卡检索凭据的 UI，并提示用户输入相应的 PIN。

必须在为单线程单元初始化 COM 的线程上调用 EapHostPeerInvokeInteractiveUI。 这可以通过调用 COM API CoInitialize 来实现;如果请求者已完成 STA 线程 CoUninitialize ，则必须在退出之前调用 。

语法

DWORD EapHostPeerInvokeInteractiveUI(
  [in]  HWND       hwndParent,
  [in]  DWORD      dwSizeofUIContextData,
  [in]  const BYTE *pUIContextData,
  [out] DWORD      *pdwSizeOfDataFromInteractiveUI,
  [out] BYTE       **ppDataFromInteractiveUI,
  [out] EAP_ERROR  **ppEapError
);

参数

[in] hwndParent

显示配置对话框的父窗口的句柄。

[in] dwSizeofUIContextData

pUIContextData 参数指向的缓冲区的大小（以字节为单位）。

[in] pUIContextData

指向包含 EAPHost 中请求 UI 上下文数据的缓冲区的指针。 上下文数据由 EapHostPeerGetUIContext 返回。 缓冲区的大小为 dwSizeOfUIContextData。

[out] pdwSizeOfDataFromInteractiveUI

指向 DWORD 的指针，该 DWORD 表示 ppDataFromInteractiveUI 参数指向的缓冲区的大小（以字节为单位）。

[out] ppDataFromInteractiveUI

指向字节缓冲区的指针的指针，该缓冲区包含身份验证继续所需的交互式 UI 中的数据。 参数 ppDataFromInteractiveUI 应作为 IN 参数 pUIContextData 传递给 EapHostPeerSetUIContext。 使用数据后，必须通过调用 EapHostPeerFreeMemory 来释放此内存。 缓冲区的大小为 pdwSizeofDataFromInteractiveUI。

[out] ppEapError

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

返回值

无

备注

请求方应在返回 EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED 调用 ，请求方应通过调用 EapHostPeerInvokeInteractiveUI 来使用调用方法交互式 UI 的传统模型。

如果已调用，则 EapHostPeerInvokeInteractiveUI 将在请求者调用 EapHostPeerGetUIContext 后引发 EAP 方法的用户界面。 当对 EapHostPeerProcessReceivedPacket 的调用返回 EapHostPeerResponseInvokeUi 操作代码时，将发生这种情况。 EapHostPeerGetUIContext 返回请求者随后传递给 EapHostPeerInvokeInteractiveUI 以引发 UI 的 UI 上下文。

要求

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

另请参阅

EAPHost 请求配置函数

EapHostPeerGetUIContext

EapHostPeerQueryInteractiveUIInputFields

EapHostPeerSetUIContext