EapHostPeerGetResult 函数 (eappapis.h)
获取指定 EAP 身份验证会话的身份验证结果。
语法
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
参数
[in] sessionHandle
指向 EAP_SESSIONID 结构的指针，该结构包含 EAPHost 服务器上此 EAP 身份验证会话的唯一句柄。 在上一次调用 EapHostPeerBeginSession 时，此句柄在 pSessionId 参数中返回。
[in] reason
一个 EapHostPeerMethodResultReason 枚举值，该值指定 ppResult 中返回的身份验证结果的原因代码。
[out] ppResult
指向包含身份验证结果的 EapHostPeerMethodResultReason 结构的指针。 EAPHost 使用 EapHostPeerMethodResult 中定义的身份验证相关信息填充此结构。
[out] ppEapError
指向EAP_ERROR结构的地址 的 指针。 在调用此函数之前，地址应设置为 NULL 。 如果错误数据可用，则会收到指向 EAP_ERROR 结构的地址的指针，该结构包含执行此函数调用期间引发的任何错误。 请求者必须引用此参数来确定身份验证是否成功。 使用错误数据后，通过调用 EapHostPeerFreeEapError 释放此内存。
返回值
如果函数成功，则返回值 NO_ERROR。 返回值不指示身份验证是否成功。 请求者必须引用 ppEapError 参数来确定身份验证结果。
如果函数失败，则返回值应为 Winerror.h、Raserror.h 或 Mprerror.h 中的相应错误代码。
注解
请求方在完成身份验证时调用 EapHostPeerGetResult ，这在以下任何情况下都可能发生。
- 对 EapHostPeerProcessReceivedPacket 的调用返回了 EapHostPeerResponseResult 操作代码。
- 客户端超时，希望根据当前状态获取结果。
- 请求者收到了一个备用结果，可能是来自下层的数据包。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | eappapis.h |
| Library | Eappprxy.lib |
| DLL | Eappprxy.dll |