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

Статья
08/08/2023

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

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

Синтаксис

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

DWORD Dot11extSetDefaultKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
  [in]           DOT11_DIRECTION dot11Direction
)
{...}

Параметры

[in, optional] hDot11SvcHandle

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

[in] pKey

Указатель на DOT11_CIPHER_DEFAULT_KEY_VALUE структуру, которая определяет ключ шифра.

[in] dot11Direction

Значение DOT11_DIRECTION , указывающее, можно ли использовать ключ только для полученных пакетов (DOT11_DIR_INBOUND) или полученных и отправленных пакетов (DOT11_DIR_BOTH).

Примечание Библиотека DLL расширений IHV не должна передавать значение DOT11_DIR_OUTBOUND этому параметру.

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

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

Ключ шифра по умолчанию определяется путем задания элемента MacAddr DOT11_CIPHER_DEFAULT_KEY_VALUE структуру на значение 0x000000000000. Ключ шифра для каждой станции по умолчанию определяется путем задания члену MacAddr допустимого mac-адреса управления доступом к одноадресным носителям (MAC).

Ключ шифра удаляется из таблиц ключей адаптера, если элемент bDelete элемента DOT11_CIPHER_DEFAULT_KEY_VALUE структура имеет значение TRUE.

Требования

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