функция обратного вызова DOT11EXT_ONEX_START (wlanihv.h)

Статья
05/23/2024

ВажноСобственный интерфейс беспроводной локальной сети 802.11 не рекомендуется использовать в Windows 10 и более поздних версиях. Вместо этого используйте WLAN Device Driver Interface (WDI). Дополнительные сведения о WDI см. в статье Модель универсального драйвера WLAN для Windows.

Библиотека DLL расширений IHV вызывает функцию Dot11ExtStartOneX для запуска операции проверки подлинности 802.1X с точкой доступа (AP). В этом случае проверка подлинности управляется модулем 802.1X платформы Native 802.11 вместо библиотеки DLL расширений IHV.

Синтаксис

DOT11EXT_ONEX_START Dot11extOnexStart;

DWORD Dot11extOnexStart(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] EAP_ATTRIBUTES *pEapAttributes
)
{...}

Параметры

[in, optional] hDot11SvcHandle

Дескриптор, используемый операционной системой для ссылки на адаптер беспроводной локальной сети (WLAN). Это значение дескриптора было указано при предыдущем вызове функции IHV Handler Dot11ExtIhvInitAdapter .

[in, optional] pEapAttributes

Указатель на структуру массива EAP_ATTRIBUTES, содержащую атрибуты EAP, возвращаемые сеансом проверки подлинности. Дополнительные сведения о EAP_ATTRIBUTES см. в документации по Microsoft Windows SDK.

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

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

Библиотека DLL расширений IHV может инициировать операцию проверки подлинности 802.1X с помощью модуля 802.1X платформы Native 802.11. Это позволяет библиотеке DLL использовать стандартные алгоритмы расширенной проверки подлинности (EAP), поддерживаемые операционной системой.

Библиотека DLL расширений IHV инициирует операцию проверки подлинности 802.1X, вызывая функцию Dot11ExtStartOneX . Метод Dot11ExtStartOneX можно вызывать только во время операции после сопоставления или после ее завершения. Дополнительные сведения об этой операции см. в разделе Операции после сопоставления.

При вызове функции Dot11ExtStartOneX операционная система отправляет пакет запуска EAP по локальной сети (EAPOL) в AP. Если AP не отвечает после трех передач пакета EAPOL-Start, операционная система не выполняет операцию проверки подлинности 802.1X и вызывает Dot11ExtIhvOneXIndicateResult Функция обработчика IHV. Дополнительные сведения о пакете EAPOL-Start см. в статье 7.5 и предложении 8.4.2 стандарта IEEE 802.1X-1999.

После запуска операции проверки подлинности 802.1X библиотека DLL расширений IHV должна следовать этим рекомендациям.

Расширения IHV должны пересылать все пакеты EAPOL в операционную систему для обработки. Когда библиотека DLL получает пакет EAPOL через вызов функции IHV Handler Dot11ExtIhvReceivePacket , библиотека DLL должна вызвать Dot11ExtProcessOneXPacket , чтобы перенаправить пакет в операционную систему.
Дополнительные сведения о пакетах EAPOL см. в разделе 7 стандарта IEEE 802.1X-2001.

Примечание Библиотека DLL расширений IHV отвечает за обработку пакетов EAPOL-Key и не должна пересылать их в операционную систему.
После завершения операции проверки подлинности 802.1X операционная система вызывает Dot11ExtIhvOneXIndicateResult Функция обработчика IHV, указывающая, что авторизация выполняется.
Библиотека DLL расширений IHV может отменить операцию проверки подлинности 802.1X, вызвав Dot11ExtStopOneX.

Дополнительные сведения об использовании модуля 802.1X для проверки подлинности см. в разделе Интерфейс к модулю 802.11 802.1X.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wlanihv.h (включая Wlanihv.h)