EapPeerSetUIContext 函数 (eapmethodpeerapis.h)

为 EAP 方法提供用户界面上下文。 在通过 EapPeerGetUIContext 函数引发 UI 后调用此函数。

语法

DWORD EapPeerSetUIContext(
  [in]  EAP_SESSION_HANDLE  sessionHandle,
  [in]  DWORD               dwSizeOfUIContextData,
  [in]  const BYTE          *pUIContextData,
  [in]  EapPeerMethodOutput *pEapOutput,
  [out] EAP_ERROR           **ppEapError
);

参数

[in] sessionHandle

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

[in] dwSizeOfUIContextData

指向值的指针,该值指定 pUIContextData 中提供的 UI 上下文数据字节缓冲区的大小。

[in] pUIContextData

指向包含字节缓冲区的地址的指针,其中包含要设置在 EAPHost 上的新请求 UI 上下文数据。

[in] pEapOutput

指向 EapPeerMethodOutput 结构的指针,该结构包含数据包处理操作的输出。

[out] ppEapError

指向 EAP_ERROR 结构的地址的指针,该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后,必须通过传递指向 EapPeerFreeErrorMemory 的指针来释放此内存。

返回值

备注

此调用由基于对等的 EAPHost 使用指向此 API 的函数指针执行。 此 API 必须在 EAPHost 加载的 EAP 方法上实现,并且必须严格遵循文档中指定的语法和参数类型。

要求

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

另请参阅

EAPHost 对等方法 Run-Time 函数

EapPeerGetUIContext