EapHostPeerSetResponseAttributes 函数 (eappapis.h)
向 EAPHost 提供更新的 EAP 身份验证属性。
语法
DWORD EapHostPeerSetResponseAttributes(
[in] EAP_SESSIONID sessionHandle,
[in] const EapAttributes * const pAttribs,
[out] EapHostPeerResponseAction *pEapOutput,
[out] EAP_ERROR **ppEapError
);
参数
[in] sessionHandle
指向 EAP_SESSIONID 结构的指针,该结构包含 EAPHost 服务器上此 EAP 身份验证会话的唯一句柄。 在上一次调用 EapHostPeerBeginSession 时,此句柄在 pSessionId 参数中返回。
[in] pAttribs
指向 EapAttributes 结构的指针,该结构包含要为 EAPHost 上的请求者设置的新 EAP 身份验证响应属性数组。
[out] pEapOutput
指向 EapHostPeerResponseAction 枚举值的指针,该值指定请求者必须作为响应执行的下一步的操作代码。
[out] ppEapError
指向EAP_ERROR结构的地址 的 指针。 在调用此函数之前,地址应设置为 NULL 。 如果错误数据可用,则会收到指向 EAP_ERROR 结构的地址的指针,该结构包含执行此函数调用期间引发的任何错误。 使用错误数据后,通过调用 EapHostPeerFreeEapError 释放此内存。
返回值
无
备注
若要在调用 EapHostPeerGetResponseAttributes 后进入状态机中的下一步,请求者必须调用 EapHostPeerSetResponseAttributes。 即使请求方无法使用从 EapHostPeerGetResponseAttributes 返回的属性,请求方也必须这样做才能传递有效的 EapAttributes 结构。
下面的示例演示了一个 EapHostPeerSetResponseAttributes 调用,该调用仅用于进入状态机中的下一个状态。
EapHostPeerGetResponseAttributes(session_id, &eapAttributes, ppEapError);
// overwrite attributes returned by EapHostPeerGetResponseAttributes
EapAttributes eapAttributes={0,NULL};
// progress to the next state in the state machine
EapHostPeerSetResponseAttributes(session_id, &eapAttributes, pEapOutput, ppEapError);
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | eappapis.h |
Library | Eappprxy.lib |
DLL | Eappprxy.dll |