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

请参阅

EAPHost 请求运行时函数

EapHostPeerGetResponseAttributes