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

Статья
08/08/2023

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

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

Синтаксис

DOT11EXTIHV_PERFORM_PRE_ASSOCIATE Dot11extihvPerformPreAssociate;

DWORD Dot11extihvPerformPreAssociate(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [in]           PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDWORD pdwReasonCode
)
{...}

Параметры

[in, optional] hIhvExtAdapter

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

[in, optional] hConnectSession

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

[in, optional] pIhvProfileParams

Указатель на DOT11EXT_IHV_PROFILE_PARAMS структура. Эта структура определяет атрибуты сети базового набора служб (BSS), к которой будут применяться расширения профиля.

[in] pIhvConnProfile

Указатель на DOT11EXT_IHV_CONNECTIVITY_PROFILE структура, содержащая параметры подключения для профиля IHV.

[in] pIhvSecProfile

Указатель на DOT11EXT_IHV_SECURITY_PROFILE структура, указывающая параметры безопасности для профиля IHV.

[in] pConnectableBssid

Указатель на структуру DOT11_BSS_LIST , которая содержит один или несколько кадров маяка или ответа пробы 802.11 для идентификатора набора служб (SSID) сети BSS, с которой библиотека DLL будет выполнять операцию предварительной связи.

[out] pdwReasonCode

Указатель на значение DWORD, которое предоставляет дополнительные сведения для возвращаемого значения функции Dot11ExtIhvPerformPreAssociate . Библиотека DLL расширений IHV должна задать для * pdwReasonCode значение L2_REASON_CODE_xxxx, определенное в L2cmn.h.

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

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

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

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

Операция предварительной связи должна быть выполнена асинхронно из вызова Dot11ExtIhvPerformPreAssociate. После завершения операции предварительного связывания библиотека DLL расширений IHV должна вызвать Dot11ExtPreAssociateCompletion.

При вызове функции Dot11ExtIhvPerformPreAssociate БИБЛИОТЕКА расширений IHV должна соответствовать этим рекомендациям.

Если библиотека DLL расширений IHV может инициировать операцию предварительной связи, функция Dot11ExtIhvPerformPreAssociate должна вернуть ERROR_SUCCESS и завершить операцию асинхронно.
Библиотека DLL расширений IHV предоставляет дополнительные сведения об инициации операции предварительной связи с помощью параметра pdwReasonCode . Библиотека DLL должна задать для * pdwReasonCode одно из следующих свойств:
- L2_REASON_CODE_SUCCESS, если операция предварительного сопоставления может быть успешно инициирована.
- Соответствующий L2_REASON_CODE_xxxx значение ошибки, если не удалось инициировать операцию предварительной связи.
- Определенное IHV значение в диапазоне от L2_REASON_CODE_IHV_BASE до (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1), независимо от того, может ли быть инициирована операция предварительной связи.

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

Требования

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