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 |