DOT11_CIPHER_KEY_MAPPING_KEY_VALUE結構（windot11.h）

發行項
02/07/2025

重要

WiFiCx 是 Windows 11 中發行的新 Wi-Fi 驅動程式模型。我們建議您使用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 可以使用任何方法來識別密鑰專案。

當 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 成員，唯一識別密鑰對應索引鍵。當 OID_DOT11_CIPHER_KEY_MAPPING_KEY 已設定，迷你埠驅動程式只有在 set 要求中的 PeerMacAddr 值 和 Direction 成員符合現有索引鍵的成員時，才能修改或刪除現有的索引鍵。

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