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

Статья
08/08/2023

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

Структура 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, драйвер мини-порта должен добавить или обновить ключ, на который ссылается 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 однозначно идентифицирует ключи сопоставления ключей с помощью элементов PeerMacAddr и Direction . При установке клиента OID_DOT11_CIPHER_KEY_MAPPING_KEY задано, драйвер мини-порта может изменять или удалять существующий ключ только в том случае, если значения элементов PeerMacAddr и Direction из запроса set совпадают с элементами существующего ключа.

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

bStatic
usKeyLength
ucKey

Требования

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