EapHostPeerSetUIContext 函数 (eappapis.h)

为引发 UI 后在 EAPHost 上加载的 EAP 对等方法提供新的或更新的用户界面上下文。 有关引发 UI 的详细信息,请参阅 EapHostPeerGetUIContext

EapHostPeerSetUIContext 设置从调用 EapHostPeerInvokeInteractiveUI 收到的 UI 上下文数据。

语法

DWORD EapHostPeerSetUIContext(
  [in]  EAP_SESSIONID             sessionHandle,
  [in]  DWORD                     dwSizeOfUIContextData,
  [in]  const BYTE * const        pUIContextData,
  [out] EapHostPeerResponseAction *pEapOutput,
  [out] EAP_ERROR                 **ppEapError
);

参数

[in] sessionHandle

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

[in] dwSizeOfUIContextData

pUIContextData 中提供的用户界面上下文数据缓冲区的大小(以字节为单位)。

[in] pUIContextData

指向字节缓冲区的指针,该缓冲区包含要设置在 EAPHost 上的新请求 UI 上下文数据。 数据从 EapHostPeerInvokeInteractiveUI OUT 参数返回。

[out] pEapOutput

指向 EapHostPeerResponseAction 枚举值的指针,该值指定请求者必须采取的下一步响应的操作代码。

[out] ppEapError

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

返回值

要求

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

请参阅

EAPHost 请求运行时函数

EapHostPeerGetUIContext

EapHostPeerInvokeInteractiveUI