windot11.h) (DOT11_CIPHER_KEY_MAPPING_KEY_VALUE 结构

项目
02/27/2024

重要本机 802.11 无线 LAN 接口在 Windows 10 及更高版本中已弃用。请改用 WLAN 设备驱动程序接口 (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 地址。对等机要么是基础结构 BSS 网络) 的接入点 (AP) (，要么是与 802.11 工作站关联的独立 BSS 网络) 的对等站 (。

此成员用于唯一标识键项。对于标准 802.11 密码算法，操作系统将通过对等方的 MAC 地址标识对等方。对于独立硬件供应商 (IHV) 开发的专有密码算法，IHV 可以使用任何方法来标识密钥条目。

当 NIC 处于 Extensible Access Point (ExtAP) OP 模式时， 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]

密钥材料。

如果 AlgorithmId 设置为 DOT11_CIPHER_ALGO_TKIP，则 ucKey 数组通过定义密钥材料 DOT11_KEY_ALGO_TKIP_MIC 结构。

如果 AlgorithmId 设置为 DOT11_CIPHER_ALGO_CCMP， 则 ucKey 数组通过 DOT11_KEY_ALGO_CCMP 结构。

注解

Native 802.11 微型端口驱动程序通过 PeerMacAddr 和 Direction 成员唯一标识键映射键。在 Windows 计算机上安装设置OID_DOT11_CIPHER_KEY_MAPPING_KEY ，仅当集请求中的 PeerMacAddr 和 Direction 成员的值与现有密钥的成员匹配时，微型端口驱动程序才能修改或删除现有键。

如果 bDelete 成员为 TRUE，则以下成员无效，必须忽略：