Поделиться через

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

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

Синтаксис

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

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

[in, optional] pIhvConnProfile

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

[in, optional] pIhvSecProfile

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

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

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

Комментарии

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

При вызове функции Dot11ExtSetCurrentProfile библиотека DLL расширений IHV должна соответствовать следующим рекомендациям:

  • Библиотека DLL расширений IHV должна вызывать dot11ExtSetCurrentProfile только при выполнении операции предварительной связи, инициированной вызовом метода Dot11ExtIhvPerformPreAssociate Функция обработчика IHV. Дополнительные сведения об операции предварительной ассоциации см. в разделе Операция предварительного связывания.
  • Библиотека DLL расширений IHV не должна вызывать Dot11ExtSetCurrentProfile из вызова Dot11ExtIhvPerformPreAssociate Функция обработчика IHV. Метод Dot11ExtSetCurrentProfile должен вызываться из потока, отличного от потока, обрабатывающего вызов Dot11ExtIhvPerformPreAssociate.

Требования

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

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

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE