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

Статья
08/08/2023

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

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

Синтаксис

DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Dot11extSetProfileCustomUserData;

DWORD Dot11extSetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [in]           DWORD dwDataSize,
  [in]           LPVOID pvData
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

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

[in] dwSessionID

Идентификатор сеанса (идентификатор сеанса) текущего пользователя.

[in] dwDataSize

Размер (в байтах) буфера, на который ссылается pvData .

[in] pvData

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

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

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

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

Для каждого профиля беспроводной беспроводной локальной сети, используемого службой автоконфигурирования Собственный Wi-Fi, Windows поддерживает концепцию пользовательских данных. Эти пользовательские данные изначально отсутствуют, но их можно задать, вызвав функцию Dot11ExtSetProfileCustomUserData . Пользовательские данные пользователя сбрасываются на пустые при изменении профиля путем вызова Функция Dot11ExtSetCurrentProfile .

После настройки пользовательских данных к этим данным можно получить доступ с помощью Функция Dot11ExtGetProfileCustomUserData . Операционная система хранит данные в системном реестре HKEY_CURRENT_USER ключ для пользователя, на который ссылается дескриптор, переданный в параметре dwSessionID .

Требования

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

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

Dot11ExtIhvInitAdapter

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData

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