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 |