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

Статья
08/08/2023

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

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

Синтаксис

DOT11EXTIHV_VALIDATE_PROFILE Dot11extihvValidateProfile;

DWORD Dot11extihvValidateProfile(
  [in, optional] HANDLE hIhvExtAdapter,
  [in, optional] PDOT11EXT_IHV_PROFILE_PARAMS pIhvProfileParams,
  [in]           PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in]           PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile,
  [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.

[out] pdwReasonCode

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

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

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

Библиотека DLL расширений IHV проверяет допустимость заданных пользователем параметров профиля для общих атрибутов сети базового набора служб (BSS), к которой будет применяться профиль. На сетевые атрибуты BSS ссылается параметр pIhvProfileParams .
Если данные пользователя действительны для расширений сетевого профиля, Dot11ExtIhvValidateProfile должен возвращать ERROR_SUCCESS. В противном случае функция должна возвращать соответствующий код ошибки из ERROR_xxxx значений, определенных в Winerror.h.
Библиотека DLL расширений IHV предоставляет дополнительные сведения о результатах проверки пользовательских данных. Библиотека DLL должна задать для * pdwReasonCode одно из следующих свойств:
- L2_REASON_CODE_SUCCESS, если данные пользователя действительны.
- Соответствующий L2_REASON_CODE_xxxx значение ошибки, если данные пользователя недопустимы.
- Определенное значение IHV в диапазоне от L2_REASON_CODE_IHV_BASE до (L2_REASON_CODE_IHV_BASE+ L2_REASON_CODE_GROUP_SIZE-1) независимо от допустимости пользовательских данных.

Дополнительные сведения о схеме XML native 802.11 см. в документации по Microsoft Windows SDK.

Требования

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

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

DOT11EXT_IHV_CONNECTIVITY_PROFILE

DOT11EXT_IHV_PROFILE_PARAMS

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE