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

Статья
08/08/2023

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

Библиотека DLL расширений IHV вызывает функцию Dot11ExtPreAssociateCompletion для асинхронного завершения операции предварительной связи, инициированной путем вызова Dot11ExtIhvPerformPreAssociate Функция обработчика IHV.

Синтаксис

DOT11EXT_PRE_ASSOCIATE_COMPLETION Dot11extPreAssociateCompletion;

DWORD Dot11extPreAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

Дескриптор, используемый операционной системой для ссылки на сеанс подключения к сети базового набора служб (BSS). Это значение дескриптора было указано при предыдущем вызове Dot11ExtIhvPerformPreAssociate Функция обработчика IHV.

[in] dwReasonCode

Значение типа , предоставляющее дополнительные сведения о состоянии завершения операции перед связыванием. Библиотека DLL расширений IHV должна задать для dwReasonCode значение L2_REASON_CODE_xxxx, определенное в L2cmn.h.

Библиотека DLL расширений IHV возвращает общее состояние завершения операции предварительной связи с помощью параметра dwWin32Error . Как правило, библиотека DLL расширений IHV задает dwReasonCode значение в диапазоне от L2_REASON_CODE_IHV_BASE до (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).

[in] dwWin32Error

Состояние завершения операции предварительной связи, определяемое кодом ошибки в Winerror.h. Если операция завершается успешно, библиотека DLL расширений IHV должна задать для dwWin32Error значение ERROR_SUCCESS.

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

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

Если операция предварительной связи успешно завершена, библиотека DLL расширений IHV должна задать для параметра dwReasonCode одно из следующих значений:
- L2_REASON_CODE_SUCCESS.
- Определенное IHV значение в диапазоне от L2_REASON_CODE_IHV_BASE до (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
В этом случае библиотека DLL расширений IHV должна задать для dwWin32Error значение ERROR_SUCCESS.
Если операция предварительного сопоставления завершилась сбоем, библиотека DLL расширений IHV не должна задавать для dwReasonCode значение L2_REASON_CODE_SUCCESS. Вместо этого библиотека DLL должна задать для dwReasonCode одно из следующих значений:
- Соответствующее значение ошибки L2_REASON_CODE_xxxx.
- Определенное IHV значение в диапазоне от L2_REASON_CODE_IHV_BASE до (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
В этом случае библиотека DLL расширений IHV не должна устанавливать для dwWin32Error значение ERROR_SUCCESS. Вместо этого библиотека DLL должна задать для dwWin32Error соответствующий код ошибки, определенный в Winerror.h.
Библиотека DLL расширений IHV должна вызывать Dot11ExtPreAssociateCompletion , чтобы отменить все ожидающие операции предварительной связи при каждом вызове функций IHV Handler Dot11ExtIhvAdapterReset или Dot11ExtIhvDeinitAdapter . В этом случае библиотека DLL должна задать для параметра dwWin32Error значение ERROR_CANCELLED.

Требования

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

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

Dot11ExtIhvAdapterReset

Dot11ExtIhvDeinitAdapter

Dot11ExtIhvInitAdapter

Собственные функции обработчика IHV 802.11

Dot11ExtIhvPerformPreAssociate