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

Статья
08/08/2023

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

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

Синтаксис

DOT11EXT_POST_ASSOCIATE_COMPLETION Dot11extPostAssociateCompletion;

DWORD Dot11extPostAssociateCompletion(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hSecuritySessionID,
  [in, optional] PDOT11_MAC_ADDRESS pPeer,
  [in]           DWORD dwReasonCode,
  [in]           DWORD dwWin32Error
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in, optional] hSecuritySessionID

Дескриптор идентификатора сеанса безопасности, возвращенного при предыдущем вызове Dot11ExtIhvPerformPostAssociate Функция обработчика IHV.

[in, optional] pPeer

Mac-адрес точки доступа (AP), с которой библиотека DLL расширений IHV выполнила операцию безопасности. Этот параметр имеет формат структуры DOT11_MAC_ADDRESS .

Примечание В Windows Vista библиотека DLL расширений IHV поддерживает только сети базового набора служб инфраструктуры (BSS).

[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.

Завершение операции после сопоставления, инициированной вызовом Dot11ExtIhvPerformPostAssociate Функция обработчика IHV.
После завершения операции после сопоставления укажите изменение состояния порта для сеанса безопасности, на который ссылается параметр hSecuritySessionID .
Например, если состояние авторизации порта меняется, библиотека DLL расширений IHV может уведомить операционную систему, вызвав Метод Dot11ExtPostAssociateCompletion.

Библиотека DLL расширений IHV должна соответствовать этим рекомендациям при вызове функции Dot11ExtPostAssociateCompletion .

Если операция после сопоставления успешно завершена, библиотека 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 задает для dwWin32Error значение ERROR_SUCCESS, операционная система предполагает, что состояние порта для сеанса безопасности находится в авторизованном состоянии. После того как порт находится в авторизованном состоянии, операционная система разрешает отправку всех пакетов данных через адаптер WLAN.
Если операция после ассоциации завершилась сбоем, библиотека 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 не устанавливает для dwWin32Error значение ERROR_SUCCESS, операционная система предполагает, что состояние порта для сеанса безопасности находится в неавторизованном состоянии. После того как порт находится в несанкционированном состоянии, операционная система разрешает отправку пакетов безопасности, включая пакеты, отправленные через функцию Расширения IHV Dot11ExtSendPacket , через адаптер WLAN.
Библиотека DLL расширений IHV должна вызывать Dot11ExtPostAssociateCompletion , чтобы отменить все ожидающие операции после ассоциации при каждом вызове функций IHV Handler Dot11ExtIhvAdapterReset или Dot11ExtIhvDeinitAdapter IHV Handler. В этом случае библиотека DLL должна задать параметру dwStatus значение ERROR_CANCELLED.

Требования

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