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 封包編號。
如果 bDelete 為 TRUE，迷你埠驅動程序必須忽略此成員。
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 所參考的預設索引鍵：
- 透過 OID_DOT11_CIPHER_DEFAULT_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 結構定義索引鍵材質。
如果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) |