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

Статья
08/08/2023

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

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

Синтаксис

DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;

DWORD Dot11extSetDefaultKeyId(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           ULONG uDefaultKeyId
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in] uDefaultKeyId

Значение индекса ключа в таблицах ключей шифра адаптера по умолчанию или для каждой станции.

Для стандартных алгоритмов шифрования 802.11, таких как WEP или TKIP, uDefaultKeyId должен иметь значение от 0 до 3. Для собственного алгоритма шифра, разработанного IHV, uDefaultKeyId может быть любым значением в диапазоне, определенном IHV.

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

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

Идентификатор ключа по умолчанию указывает индекс ключа шифра в ключах адаптера по умолчанию и таблицах ключей по умолчанию для каждой станции, которые адаптер использует для шифрования данных. Адаптер использует ключ шифра, на который ссылается идентификатор ключа по умолчанию, в качестве ключа шифрования по умолчанию для передаваемых пакетов, если для mac-адреса назначения не существует ключ сопоставления ключей. Дополнительные сведения об этих типах ключей шифра см. в разделе Типы ключей шифра 802.11.

Вызов функции Dot11ExtSetDefaultKeyId приводит к запросу набора OID_DOT11_CIPHER_DEFAULT_KEY_ID идентификатор объекта (OID) в драйвер мини-порта Native 802.11, который управляет адаптером WLAN.

Требования

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

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

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

Типы ключей шифра 802.11