функция обратного вызова DOT11EXTIHV_VALIDATE_PROFILE (wlanihv.h)
Синтаксис
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.
Комментарии
Операционная система вызывает функцию Dot11ExtIhvValidateProfile для проверки заданных пользователем параметров сетевого профиля перед обработкой или сохранением профиля.
При вызове функции Dot11ExtIhvValidateProfile библиотека DLL расширений IHV следует следующим рекомендациям:
- Библиотека 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) независимо от допустимости пользовательских данных.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wlanihv.h (включая Wlanihv.h, L2cmn.h) |