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 方法上实现，并且必须严格遵循文档中指定的语法和参数类型。

要求

另请参阅

EAPHost 对等方法 Run-Time 函数

EapPeerInvokeInteractiveUI

EapPeerSetUIContext