Функция RasEapGetInfo (raseapif.h)

Диспетчер соединений RAS вызывает RasEapGetInfo , чтобы получить набор указателей функций для указанного протокола проверки подлинности.

Синтаксис

DWORD RasEapGetInfo(
  [in]  DWORD        dwEapTypeId,
  [out] PPP_EAP_INFO *pEapInfo
);

Параметры

[in] dwEapTypeId

Указывает протокол проверки подлинности, для которого требуется получить сведения.

[out] pEapInfo

Указатель на структуру PPP_EAP_INFO . Структура получает элементы, устанавливаемые RAS для определения версии структуры и протокола проверки подлинности, для которого запрашиваются указатели функций. Дополнительные сведения см. в разделе PPP_EAP_INFO.

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

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается ошибкой, возвращаемое значение должно быть соответствующим кодом ошибки из Winerror.h, Raserror.h или Mprerror.h.

Комментарии

Библиотека DLL, реализующая RasEapGetInfo , может поддерживать несколько протоколов проверки подлинности. Параметр dwEapTypeId указывает, для какого протокола проверки подлинности требуется получить сведения.

Реализации EAP должны экспортировать функцию RasEapGetInfo , так как RAS использует RasEapGetInfo для получения указателей на другие функции протокола проверки подлинности.

После инициализации диспетчер подключений вызывает RasEapGetInfo для каждой библиотеки DLL EAP, установленной в подразделе реестра, как описано в обзоре EAP.

Если функция возвращает любое значение, отличное от NO_ERROR, RAS считает протокол проверки подлинности нефункциональным. RAS публикует ошибку в журнале событий Windows NT/Windows 2000, указывая, что этот протокол запущен неправильно и, следовательно, недоступен.

Требования

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

Общие сведения об EAP (расширяемый протокол проверки подлинности)

Функции EAP

Справочник по протоколу расширенной проверки подлинности

PPP_EAP_INFO