EapPeerGetUIContext 函数 (eapmethodpeerapis.h)
从 EAP 方法获取用户界面上下文。 此函数后跟 EapPeerInvokeInteractiveUI 函数,后跟 EapPeerSetUIContext 函数。
语法
DWORD EapPeerGetUIContext(
[in] EAP_SESSION_HANDLE sessionHandle,
[out] DWORD *pdwSizeOfUIContextData,
[out] BYTE **ppUIContextData,
[out] EAP_ERROR **ppEapError
);
参数
[in] sessionHandle
指向 EAP_SESSION_HANDLE 结构的指针,该结构包含 EAPHost 服务器上此 EAP 身份验证会话的唯一句柄。 在以前调用 EapPeerBeginSession 时,此句柄在 pSessionHandle 参数中返回。
[out] pdwSizeOfUIContextData
指向值的指针,该值指定 在 ppUIContextData 中返回的用户界面上下文数据字节缓冲区的大小。
[out] ppUIContextData
指向包含字节缓冲区的地址的指针,该缓冲区包含来自 EAPHost 的请求者用户界面上下文数据。
[out] ppEapError
指向 EAP_ERROR 结构的地址的指针,该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后,必须通过将指向错误数据的指针传递给 EapPeerFreeErrorMemory 来释放此内存。
返回值
无
备注
当之前的调用指示用户界面上下文可用时,EAPHost 将调用 EapPeerGetUIContext。
此调用由基于对等的 EAPHost 使用指向此 API 的函数指针执行。 此 API 必须在 EAPHost 加载的 EAP 方法上实现,并且必须严格遵循文档中指定的语法和参数类型。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | eapmethodpeerapis.h |