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

Статья
08/08/2023

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

Операционная система вызывает функцию Dot11ExtIhvPerformPostAssociate , чтобы запросить, чтобы библиотека DLL расширений IHV инициировала операцию после сопоставления с сетью базового набора служб (BSS).

Синтаксис

DOT11EXTIHV_PERFORM_POST_ASSOCIATE Dot11extihvPerformPostAssociate;

DWORD Dot11extihvPerformPostAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hSecuritySessionID,
  [in]           PDOT11_PORT_STATE pPortState,
  [in]           ULONG uDot11AssocParamsBytes,
  [in]           PDOT11_ASSOCIATION_COMPLETION_PARAMETERS pDot11AssocParams
)
{...}

Параметры

[in, optional] hIhvExtAdapter

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

[in, optional] hSecuritySessionID

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

[in] pPortState

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

[in] uDot11AssocParamsBytes

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

[in] pDot11AssocParams

Указатель на DOT11_ASSOCIATION_COMPLETION_PARAMETERS структуры, которая указывает результат операции связи, завершенной адаптером WLAN. Драйвер минипорта native 802.11, который управляет адаптером WLAN, включает структуру DOT11_ASSOCIATION_COMPLETION_PARAMETERS, когда он создает носитель NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION индикация.

Дополнительные сведения об операции сопоставления см. в разделе Операции сопоставления.

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

Если библиотека DLL расширения IHV может инициировать операцию после ассоциации, она должна завершить операцию асинхронно. В этом случае функция возвращает ERROR_SUCCESS.

Если библиотека DLL расширений IHV не может инициировать операцию после сопоставления, она возвращает код ошибки, определенный в Winerror.h.

Операционная система вызывает функцию Dot11ExtIhvPerformPostAssociate для запуска операции после сопоставления с библиотекой DLL расширений IHV. Операционная система инициирует эту операцию после того, как адаптер WLAN завершит операцию связи с точкой доступа (AP) в сети базового набора служб инфраструктуры (BSS).

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

Дополнительные сведения об операции сопоставления см. в разделе Операции сопоставления.

Операция после ассоциации должна быть завершена асинхронно из вызова Dot11ExtIhvPerformPostAssociate. После завершения операции после ассоциации библиотека DLL должна вызвать Dot11ExtPostAssociateCompletion.

Если библиотека DLL расширений IHV может инициировать операцию после ассоциации, функция Dot11ExtIhvPerformPostAssociate должна вернуть ERROR_SUCCESS и завершить операцию асинхронно.

Дополнительные сведения об операции после ассоциации см. в разделе Операции после ассоциации.

Требования

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

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

Dot11ExtPostAssociateCompletion

Dot11ExtIhvInitAdapter

DOT11_PORT_STATE

Dot11ExtIhvAdapterReset

NDIS_STATUS_DOT11_ASSOCIATION_COMPLETION