EapHostPeerGetUIContext 函数 (eappapis.h)

如果要引发 UI,则从 EAPHost 获取请求人的用户界面上下文。

EAPHostPeerGetUIContext 始终后跟以下函数。

语法

DWORD EapHostPeerGetUIContext(
  [in]  EAP_SESSIONID sessionHandle,
  [out] DWORD         *pdwSizeOfUIContextData,
  [out] BYTE          **ppUIContextData,
  [out] EAP_ERROR     **ppEapError
);

参数

[in] sessionHandle

指向 EAP_SESSIONID 结构的指针,该结构包含 EAPHost 服务器上的此 EAP 身份验证会话的唯一句柄。 在上一次调用 EapHostPeerBeginSession 时,此句柄在 pSessionId 参数中返回。

[out] pdwSizeOfUIContextData

指向值的指针,该值指定 ppUIContextData 中返回的 UI 上下文数据缓冲区的大小(以字节为单位)。

[out] ppUIContextData

指向包含 EAPHost 中请求 UI 上下文数据的缓冲区的指针的指针。 此参数指向的地址作为 IN 参数 pUIContextData 传递给 EapHostPeerInvokeInteractiveUI

[out] ppEapError

指向 EAP_ERROR 结构的地址的指针。 在调用此函数之前,地址应设置为 NULL 。 如果错误数据可用,则会收到指向 EAP_ERROR 结构的地址的指针,该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后,通过调用 EapHostPeerFreeEapError 释放此内存。

返回值

要求

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

另请参阅

EAPHost 请求运行时函数

EapHostPeerInvokeInteractiveUI

EapHostPeerSetUIContext