функция обратного вызова DOT11EXTIHV_PERFORM_CAPABILITY_MATCH (wlanihv.h)
Операционная система вызывает функцию 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.
[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).
-
Если библиотека 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).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wlanihv.h (включая Wlanihv.h, Winclient.h, L2cmn.h) |