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

Статья
08/08/2023

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

Библиотека DLL расширений IHV вызывает функцию Dot11ExtSetVirtualStationAPProperties для указания текущего подключения профиля IHV.

Синтаксис

DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;

DWORD Dot11extSetVirtualStationApProperties(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwNumProperties,
  [in]           PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
                 LPVOID pvReserved
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

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

[in] dwNumProperties

Количество элементов в массиве структур, на которые указывает параметр pProperties .

[in] pProperties

Указатель на массив DOT11EXT_VIRTUAL_STATION_AP_PROPERTY структуры, указывающие свойства точек доступа ,которые виртуальная станция 802.11 пытается разместить в текущем сеансе подключения.

pvReserved

Этот параметр зарезервирован для использования операционной системой и должен иметь значение NULL.

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

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

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

Если библиотека DLL расширений IHV вызывает Dot11ExtSetVirtualStationAPProperties, она должна сделать это перед вызовом Dot11ExtIhvPerformPreAssociate Функция обработчика IHV. Если метод Dot11ExtSetVirtualStationAPProperties не вызывается до успешного завершения операции предварительной связи, операционная система не делает никаких предположений относительно характера профиля IHV.

Требования

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

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

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY