Функция EapHostPeerSetResponseAttributes (eappapis.h)

Статья
08/23/2023

Предоставляет обновленные атрибуты проверки подлинности EAP для EAPHost.

Синтаксис

DWORD EapHostPeerSetResponseAttributes(
  [in]  EAP_SESSIONID               sessionHandle,
  [in]  const EapAttributes * const pAttribs,
  [out] EapHostPeerResponseAction   *pEapOutput,
  [out] EAP_ERROR                   **ppEapError
);

Параметры

[in] sessionHandle

Указатель на структуру EAP_SESSIONID , содержащую уникальный дескриптор для этого сеанса проверки подлинности EAP на сервере EAPHost. Этот дескриптор возвращается в параметре pSessionId в предыдущем вызове EapHostPeerBeginSession.

[in] pAttribs

Указатель на структуру EapAttributes , которая содержит массив новых атрибутов ответа проверки подлинности EAP, которые необходимо задать для запрашивающего объекта на EAPHost.

[out] pEapOutput

Указатель на значение перечисления EapHostPeerResponseAction , указывающее код действия для следующего шага, который запрашивающий должен принять в качестве ответа.

[out] ppEapError

Указатель на адрес структуры EAP_ERROR . Перед вызовом этой функции необходимо задать для адреса значение NULL . Если данные об ошибках доступны, получается указатель на адрес структуры EAP_ERROR , содержащей ошибки, возникающие во время выполнения этого вызова функции. После использования данных об ошибке освободите эту память, вызвав EapHostPeerFreeEapError.

Возвращаемое значение

None

Remarks

Чтобы перейти к следующему шагу конечного автомата после вызова EapHostPeerGetResponseAttributes, запрашивающий должен вызвать EapHostPeerSetResponseAttributes. Запрашивающий должен сделать это, чтобы передать допустимую структуру EapAttributes , даже если запрашивающий не может использовать атрибуты, возвращенные EapHostPeerGetResponseAttributes.

В следующем примере показан вызов EapHostPeerSetResponseAttributes , который выполняется исключительно для того, чтобы перейти к следующему состоянию в конечном автомате.

EapHostPeerGetResponseAttributes(session_id, &amp;eapAttributes, ppEapError);

// overwrite attributes returned by EapHostPeerGetResponseAttributes
EapAttributes eapAttributes={0,NULL};

// progress to the next state in the state machine
EapHostPeerSetResponseAttributes(session_id, &amp;eapAttributes, pEapOutput, ppEapError);

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	eappapis.h
Библиотека	Eappprxy.lib
DLL	Eappprxy.dll

См. также раздел

Функции среды выполнения EAPHost Supplicant

EapHostPeerGetResponseAttributes

Поделиться через