Specifying Cipher Keys

  • Artigo

Important  The Native 802.11 Wireless LAN interface is deprecated in Windows 10 and later. Please use the WLAN Device Driver Interface (WDI) instead. For more information about WDI, see WLAN Universal Windows driver model.

 

When the miniport driver is operating in Extensible Station (ExtSTA) mode, the following object identifiers (OIDs) set the cipher keys used by the 802.11 station.

Name Description

[OID_DOT11_CIPHER_DEFAULT_KEY](https://msdn.microsoft.com/library/windows/hardware/ff569119)

Sets a cipher key in either the default key table (if the set request specifies a NULL media access control (MAC) address) or the per-station (STA) default key table.

[OID_DOT11_CIPHER_KEY_MAPPING_KEY](https://msdn.microsoft.com/library/windows/hardware/ff569121)

Sets a cipher key in the key-mapping key table.

 

When a cipher key is set, the following actions can be specified in the set request:

  • The key at the specified index within the table can be added or deleted. If a key at the specified index already exists and the requested action is to add the key, the miniport driver replaces the key with the new key material defined in the set request.

  • The key at the specified index within the table can be static and must persist across connection, roam, and disconnection operations to a basic service set (BSS) network. The miniport driver removes these keys only when one of the following occurs:

When the miniport driver is operating in Extensible Station (ExtSTA) mode, the following OIDs set or query how the 802.11 station uses cipher keys.

Name Description

[OID_DOT11_CIPHER_DEFAULT_KEY_ID](https://msdn.microsoft.com/library/windows/hardware/ff569120)

Sets or queries the index of the key in the default key and per-STA default key tables that the 802.11 station uses for data encryption. The station uses this key for transmitted packets unless a key-mapping key exists for the destination MAC address.

[OID_DOT11_UNICAST_USE_GROUP_ENABLED](https://msdn.microsoft.com/library/windows/hardware/ff569433)

Sets or queries the support by the 802.11 station for the "Use Group Key" cipher suite. For more information about the "Use Group Key" cipher suite, refer to Clause 7.3.2.9.1 of the IEEE 802.11i-2004 standard.