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

Получает результат проверки подлинности для указанного сеанса проверки подлинности EAP.

Синтаксис

DWORD EapHostPeerGetResult(
  [in]  EAP_SESSIONID                 sessionHandle,
  [in]  EapHostPeerMethodResultReason reason,
  [out] EapHostPeerMethodResult       *ppResult,
  [out] EAP_ERROR                     **ppEapError
);

Параметры

[in] sessionHandle

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

[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 .
• Истекло время ожидания клиента, и он хочет получить результат на основе текущего состояния.
• Запрашивающий получил альтернативный результат, возможно, от пакета на нижнем уровне.

Требования

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

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

EapHostPeerProcessReceivedPacket