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

Статья
08/08/2023

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

Библиотека DLL расширений IHV вызывает функцию Dot11ExtProcessOneXPacket для пересылки пакетов EAP по локальной сети (EAPOL) в операционную систему для обработки во время операции проверки подлинности 802.1X с точкой доступа (AP).

Синтаксис

DOT11EXT_PROCESS_ONEX_PACKET Dot11extProcessOnexPacket;

DWORD Dot11extProcessOnexPacket(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwInPacketSize,
  [in]           LPVOID pvInPacket
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in] dwInPacketSize

Длина (в байтах) данных пакета в буфере, на который ссылается параметр pvInPacket .

[in] pvInPacket

Пакет EAPOL, полученный от AP. Параметр pvInPacket должен ссылаться на пакет EAPOL, начиная с поля типа пакета в единице данных протокола EAPOL (PDU). Дополнительные сведения о поле типа пакета EAPOL см. в пункте 7.5.4 стандарта IEEE 802.1X-2001.

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

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

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

Пока операция проверки подлинности 802.1X ожидается, библиотека DLL расширений IHV пересылает полученные пакеты EAP по локальной сети (EAPOL) в операционную систему через вызов функции Dot11ExtProcessOneXPacket . Библиотека DLL расширений IHV получает эти пакеты с помощью функции Обработчика IHV Dot11ExtIhvReceivePacket .

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

Дополнительные сведения о пакетах EAPOL см. в разделе 7 стандарта IEEE 802.1X-2001.

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

Требования

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

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

Dot11ExtIhvReceivePacket

Dot11ExtIhvInitAdapter

Dot11ExtIhvOneXIndicateResult

Dot11ExtStartOneX

Dot11ExtStopOneX