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

Статья
08/08/2023

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

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

Синтаксис

DOT11EXT_GET_PROFILE_CUSTOM_USER_DATA Dot11extGetProfileCustomUserData;

DWORD Dot11extGetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [out]          DWORD *pdwDataSize,
  [out]          LPVOID *ppvData
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in, optional] hConnectSession

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

[in] dwSessionID

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

[out] pdwDataSize

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

[out] ppvData

Адрес переменной указателя, в котором хранится адрес буфера, содержащего данные пользователя.

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

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

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

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

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

Вызывающий объект отвечает за освобождение памяти, выделенной для буфера, на который указывает параметр ppvData с помощью функции Dot11ExtFreeBuffer .

Требования

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

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

Dot11ExtIhvInitAdapter

Dot11ExtFreeBuffer

Dot11ExtSetProfileCustomUserData Dot11ExtIhvPerformPreAssociate

Dot11ExtSetCurrentProfile

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