структура DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)

Статья
02/07/2025

Важный

WiFiCx — это новая модель драйвера Wi-Fi, выпущенная в Windows 11. Мы рекомендуем использовать WiFiCx для использования новейших функций. Модель драйвера WDI теперь находится в режиме обслуживания и получит только исправления с высоким приоритетом.

Структура DOT11_CIPHER_KEY_MAPPING_KEY_VALUE определяет ключ шифра сопоставления ключей, который будет добавлен или удален из таблиц ключей на станции 802.11. Дополнительные сведения об этом типе ключа шифра см. в разделе 802.11 Типы ключей шифров.

Синтаксис

typedef struct DOT11_CIPHER_KEY_MAPPING_KEY_VALUE {
  DOT11_MAC_ADDRESS      PeerMacAddr;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_DIRECTION        Direction;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_KEY_MAPPING_KEY_VALUE, *PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE;

Члены

PeerMacAddr

MAC-адрес однорангового узла. Одноранговый узел — это точка доступа (AP) (для сетей BSS инфраструктуры) или одноранговая станция (для независимых сетей BSS), с которой связана станция 802.11.

Этот элемент используется для уникальной идентификации записи ключа. Для стандартных алгоритмов шифров 802.11 операционная система будет определять пиринг через MAC-адрес однорангового узла. Для собственных алгоритмов шифров, разработанных независимым поставщиком оборудования (IHV), IHV может использовать любой метод для идентификации записи ключа.

Если сетевой адаптер находится в режиме op точки доступа (ExtAP), PeerMacAddr должны иметь уникальное значение.

AlgorithmId

Значение алгоритма шифра, использующего этот ключ. Дополнительные сведения о значениях перечислителя для алгоритмов шифров см. в DOT11_CIPHER_ALGORITHM.

Direction

Этот член указывает, использует ли станция 802.11 ключ для получения или передачи пакетов. Тип данных для этого элемента — это перечисление DOT11_DIRECTION.

bDelete

Если задано значение TRUE, драйвер минипорта должен удалить ключ, на который ссылается PeerMacAddr и Direction. Если задано значение false false, драйвер минипорта должен добавить или обновить ключ, на который ссылается PeerMacAddr и Direction.

bStatic

Логическое значение, указывающее, должен ли минипорт-драйвер удалить ключ по умолчанию после операции подключения или перемещения.

Если задано значение false , драйвер минипорта должен удалить ключ по умолчанию, на который ссылается uKeyIndex всякий раз:

Станция 802.11 отключается от сети BSS.
Одноранговая станция отключается от сети BSS.
Станция 802.11 повторно подключается к той же сети BSS.

Если задано значение TRUE, ключ по умолчанию, на который ссылается uKeyIndex, не должен быть удален, если только это не так:

Явным образом удален с помощью запроса набора OID_DOT11_CIPHER_KEY_MAPPING_KEY.
Неявно удалено с помощью запроса метода OID_DOT11_RESET_REQUEST.

usKeyLength

Длина в байтах ключевого материала в массиве ucKey.

ucKey[*]

Ключевой материал.

Если AlgorithmId задано значение DOT11_CIPHER_ALGO_TKIP, массив ucKey определяет материал ключа через структура DOT11_KEY_ALGO_TKIP_MIC.

Если AlgorithmId задано значение DOT11_CIPHER_ALGO_CCMP, массив ucKey определяет материал ключа через DOT11_KEY_ALGO_CCMP структура.

ucKey[1]

Ключевой материал.

Замечания

Драйвер минипорта Native 802.11 однозначно идентифицирует ключи сопоставления ключей с помощью одноранговых и членов направления. Когда OID_DOT11_CIPHER_KEY_MAPPING_KEY задано, драйвер минипорта может изменять или удалять существующий ключ только в том случае, если значения PeerMacAddr и направление элементов из запроса набора соответствуют элементам существующего ключа.

Если элемент bDelete TRUE, то следующие члены недопустимы и должны игнорироваться:

bStatic
usKeyLength
ucKey

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
заголовка	windot11.h (include Ndis.h)