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

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

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

Синтаксис

DOT11EXTIHV_PERFORM_CAPABILITY_MATCH Dot11extihvPerformCapabilityMatch;

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

Параметры

[in, optional] hIhvExtAdapter

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

[in, optional] pIhvProfileParams

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

[in] pIhvConnProfile

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

[in] pIhvSecProfile

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

[in, optional] pConnectableBssid

Указатель на структуру DOT11_BSS_LIST , которая содержит один или несколько кадров маяка или ответа пробы 802.11, полученных из сети BSS. Этот список является производным от результатов последней операции сканирования, выполненной адаптером WLAN. Дополнительные сведения об операции сканирования см. в статье Операции сканирования в машинной версии 802.11.

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

[out] pdwReasonCode

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

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

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

Комментарии

После того как адаптер WLAN завершит операцию сканирования для обнаружения сетей BSS в диапазоне действия, операционная система может вызвать функцию Dot11ExtIhvPerformCapabilityMatch , чтобы определить, соответствует ли какая-либо из обнаруженных сетей BSS расширениям профиля подключения или безопасности, определенным IHV.

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

  • Если библиотека DLL расширений IHV находит по крайней мере один кадр маяка или отклика зонда IEEE 802.11, соответствующий фрагментам профиля, она должна задать для параметра * pdwReasonCode одно из следующих значений:
    • L2_REASON_CODE_SUCCESS.
    • Определенное IHV значение в диапазоне от L2_REASON_CODE_IHV_BASE до (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
    В этом случае функция Dot11ExtIhvPerformCapabilityMatch должна возвращать ERROR_SUCCESS.
  • Если библиотека DLL расширений IHV не находит фрейм маяка IEEE 802.11 или ответа пробы, соответствующий фрагментам профиля, она не должна задавать для *pdwReasonCode значение L2_REASON_CODE_SUCCESS. Вместо этого библиотека DLL должна задать для * pdwReasonCode одно из следующих значений:
    • Соответствующее значение ошибки L2_REASON_CODE_xxxx.
    • Определенное IHV значение в диапазоне от L2_REASON_CODE_IHV_BASE до (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1).
    В этом случае функция Dot11ExtIhvPerformCapabilityMatch не должна возвращать ERROR_SUCCESS.
Дополнительные сведения о схеме XML native 802.11 см. в документации по Microsoft Windows SDK.

Требования

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

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

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_SECURITY_PROFILE

DOT11_BSS_LIST

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_PROFILE_PARAMS