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

Статья
08/08/2023

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

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

Синтаксис

DOT11EXTIHV_CREATE_DISCOVERY_PROFILES Dot11extihvCreateDiscoveryProfiles;

DWORD Dot11extihvCreateDiscoveryProfiles(
  [in, optional] HANDLE hIhvExtAdapter,
  [in]           BOOL bInsecure,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in, optional] PDOT11_BSS_LIST pConnectableBssid,
  [out]          PDOT11EXT_IHV_DISCOVERY_PROFILE_LIST pIhvDiscoveryProfileList,
  [out]          PDWORD pdwReasonCode
)
{...}

Параметры

[in, optional] hIhvExtAdapter

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

[in] bInsecure

Логическое значение, указывающее состояние безопасности профилей обнаружения. Если задано значение TRUE, библиотека DLL расширений IHV может возвращать только безопасные профили, например профили, включающие проверку подлинности пользователей.

[in, optional] pIhvProfileParams

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

[in, optional] pConnectableBssid

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

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

[out] pIhvDiscoveryProfileList

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

[out] pdwReasonCode

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

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

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

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

При вызове Dot11ExtIhvCreateDiscoveryProfiles библиотека DLL расширений IHV должна соответствовать этим рекомендациям.

Если библиотека DLL расширений IHV может возвращать фрагменты профиля, которые можно использовать для подключения к сети BSS, функция Dot11ExtIhvCreateDiscoveryProfiles должна возвращать ERROR_SUCCESS. В противном случае функция должна возвращать соответствующий код ошибки из ERROR_xxxx значений, определенных в Winerror.h.
Библиотека DLL расширений IHV предоставляет дополнительные сведения о результатах, возвращаемых функцией Dot11ExtIhvCreateDiscoveryProfiles . Библиотека DLL должна задать для * pdwReasonCode одно из следующих элементов:
- L2_REASON_CODE_SUCCESS, можно ли вернуть фрагменты профиля для списка сетей BSS.
- Соответствующее L2_REASON_CODE_xxxx значение ошибки, если фрагменты профиля не могут быть возвращены для списка сетей BSS.
- Определенное 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)