DOT11_CIPHER_KEY_MAPPING_KEY_VALUE 結構 (windot11.h)

發行項
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 處於可延伸存取點 (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 成員唯一識別密鑰對應密鑰。當在 Wi-Fi 設定中的 OID_DOT11_CIPHER_KEY_MAPPING_KEY 已設定，迷你埠驅動程式只有在集合要求中的 PeerMacAddr 和 Direction 成員的值符合現有索引鍵的成員時，才能修改或刪除現有的索引鍵。

如果 bDelete 成員為 TRUE，則下列成員無效，而且必須忽略：