共用方式為


DOT11_CIPHER_DEFAULT_KEY_VALUE 結構 (windot11.h)

重要

原生 802.11 無線 LAN 介面在 Windows 10 和更新版本中已被取代。 請改用 WLAN 設備驅動器介面 (WDI) 。 如需 WDI 的詳細資訊,請參閱 WLAN 通用 Windows 驅動程式模型

DOT11_CIPHER_DEFAULT_KEY_VALUE 結構會定義預設加密金鑰或每個月臺的預設加密金鑰,這些金鑰將會新增至 802.11 月臺上的索引鍵數據表或刪除。 如需這些加密金鑰類型的詳細資訊,請參閱 802.11 加密金鑰類型

語法

typedef struct DOT11_CIPHER_DEFAULT_KEY_VALUE {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uKeyIndex;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_MAC_ADDRESS      MacAddr;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_DEFAULT_KEY_VALUE, *PDOT11_CIPHER_DEFAULT_KEY_VALUE;

成員

Header

DOT11_CIPHER_DEFAULT_KEY_VALUE 結構的型別、修訂和大小。 此成員的格式為 NDIS_OBJECT_HEADER 結構。

迷你埠驅動程序必須將 Header 的成員設定為下列值:

類型

此成員必須設定為 NDIS_OBJECT_TYPE_DEFAULT。

修訂版

此成員必須設定為 DOT11_CIPHER_DEFAULT_KEY_VALUE_REVISION_1。

大小

這個成員必須設定為 sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE)

如需這些成員的詳細資訊,請參閱 NDIS_OBJECT_HEADER

uKeyIndex

802.11 月台預設索引鍵陣列中的索引鍵。

針對標準 802.11 加密演算法, uKeyIndex 必須介於 0 到 3。 針對 IHV 所開發的加密演算法, uKeyIndex 可以是 IHV 所定義範圍內的任何值。

針對 BIP uKeyIndex 必須是 4 或 5。

IEEE 802.11-2012 標準會定義從 1 到 4 的預設索引鍵索引值。 此成員指定的值 x 會對應至 802.11 預設索引鍵索引, (x + 1) 。

AlgorithmId

使用此金鑰的加密演演算法值。 如需加密演算法值的詳細資訊,請參閱 DOT11_CIPHER_ALGORITHM

對於 BIP,這應該設定為DOT11_CIPHER_ALGO_BIP預先設定初始 IGTK 封包編號。

如果 bDeleteTRUE,迷你埠驅動程序必須忽略此成員。

MacAddr

媒體訪問控制 (MAC) 位址,可識別要新增或移除密鑰的預設索引鍵數據表。

如果 dot11DesiredBSSType 管理資訊基底 (MIB) 物件設定為 dot11_BSS_type_infrastructure,則不論 MacAddr 成員的值為何,802.11 月台都會新增或移除預設索引鍵數據表中的索引鍵。 如果從存取點動態取得密鑰, (AP) 月台相關聯, MacAddr 成員將會包含 AP 的 MAC 位址。 否則, MacAddr 的值會是 0x000000000000。

如果 dot11DesiredBSSType 管理資訊基底 (MIB) 物件設定為 dot11_BSS_type_independent,802.11 站必須以下列方式新增或移除密鑰:

  • 如果這個成員的值是0x000000000000,802.11 月臺會新增或移除預設索引鍵數據表中的索引鍵。 當 NIC 處於可延伸存取點 (ExtAP) OP 模式時,此值為零。

  • 如果此成員的值是有效的單播 MAC 位址,則 802.11 月臺會針對獨立 BSS (IBSS) 網路中的對等站新增或移除密鑰,其中 MAC 位址等於 MacAddr 的值。

如果 MacAddr 的值不存在每個月臺的預設索引鍵數據表,802.11 月台必須使用任何未使用的個別站台預設索引鍵數據表。

如需 dot11DesiredBSSType MIB 對象的詳細資訊,請參閱 OID_DOT11_DESIRED_BSS_TYPE

bDelete

布爾值,指定迷你埠驅動程式是否應該刪除預設索引鍵。

如果設定為 TRUE,迷你埠驅動程式必須刪除 uKeyIndex 所參考的預設密鑰。 如果設定為 FALSE,迷你埠驅動程式必須新增或更新 uKeyIndex 所參考的預設密鑰。

bStatic

布爾值,指定迷你埠驅動程式是否應該在連線或漫遊作業之後刪除預設密鑰。

如果設定為 FALSE,每當 802.11 月臺時,迷你埠驅動程式必須刪除 uKeyIndex 所參考的預設密鑰:

  • 中斷與基本服務集 (BSS) 網路連線。
  • 漫遊至新的 BSS 網路。
  • 重新連線到相同的 BSS 網路。

如果設定為 TRUE,除非是下列項目,否則不得刪除 uKeyIndex 所參考的預設索引鍵:

usKeyLength

ucKey 陣列中索引鍵材質的長度,以位元組為單位。

ucKey[*]

索引鍵材質。

如果AlgorithmId設定為 DOT11_CIPHER_ALGO_TKIP,ucKey 陣列會透過 DOT11_KEY_ALGO_TKIP_MIC結構定義索引鍵材質。

如果AlgorithmId設定為 DOT11_CIPHER_ALGO_CCMP,ucKey 陣列會透過 DOT11_KEY_ALGO_CCMP 結構定義索引鍵材質。

如果AlgorithmId設定為 DOT11_CIPHER_ALGO_BIP,ucKey 陣列會透過 DOT11_KEY_ALGO_BIP 結構定義索引鍵材質。

ucKey[1]

索引鍵材質。

如果AlgorithmId設定為 DOT11_CIPHER_ALGO_TKIP,ucKey 陣列會透過 DOT11_KEY_ALGO_TKIP_MIC結構定義索引鍵材質。

如果AlgorithmId設定為 DOT11_CIPHER_ALGO_CCMP,ucKey 陣列會透過 DOT11_KEY_ALGO_CCMP 結構定義索引鍵材質。

如果AlgorithmId設定為 DOT11_CIPHER_ALGO_BIP,ucKey 陣列會透過 DOT11_KEY_ALGO_BIP 結構定義索引鍵材質。

備註

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

  • bStatic
  • usKeyLength
  • ucKey

規格需求

需求
最低支援的用戶端 Windows 8 及更新版本的 Windows 作業系統中提供。
標頭 windot11.h (include Ndis.h)

另請參閱

DOT11_KEY_ALGO_TKIP_MIC

OID_DOT11_RESET_REQUEST

DOT11_CIPHER_ALGORITHM

OID_DOT11_CIPHER_DEFAULT_KEY

OID_DOT11_DESIRED_BSS_TYPE

DOT11_KEY_ALGO_CCMP

NDIS_OBJECT_HEADER