OID_DOT11_UNICAST_USE_GROUP_ENABLED

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 set, the OID_DOT11_UNICAST_USE_GROUP_ENABLED object identifier (OID) requests that the miniport driver set the Extensible Station (ExtSTA) msDot11UnicastUseGroupEnabled management information base (MIB) object to the specified value.

When queried, this OID requests that the miniport driver return the value of the msDot11UnicastUseGroupEnabled MIB object.

The msDot11UnicastUseGroupEnabled MIB object specifies whether the 802.11 station has enabled the support 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.

Note  Support for OID_DOT11_UNICAST_USE_GROUP_ENABLED is mandatory if the 802.11 station supports any Wi-Fi Protected Access (WPA) or Robust Security Network Association (RSNA) authentication algorithms. The miniport driver specifies its support for this authentication algorithm when OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR or OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR are queried.

 

The data type for OID_DOT11_UNICAST_USE_GROUP_ENABLED is a BOOLEAN value. A value of TRUE indicates that the 802.11 station has enabled the support for the "Use Group Key" cipher suite.

"Use Group Key" is a cipher suite defined for the Pairwise Key Cipher Suite List subfield of the RSN and WPA information elements (IEs). An access point (AP) uses this cipher suite if it does not support the use of a pairwise cipher algorithm for unicast packets. The AP advertises this cipher suite in the RSN and WPA IE that it sends in its Beacon and Probe Response frames. An 802.11 station that associates with the AP must use the "Use Group Key" cipher suite defined in the RSN or WPA IE for unicast packets.

The 802.11 station can associate only with an AP that advertises the "Use Group Key" cipher suite if the following are true:

  • The 802.11 station has enabled the support for the "Use Group Key" cipher suite.

  • The 802.11 station has enabled the multicast cipher suite advertised in the Beacon or Probe Response received from the AP.

The default for the msDot11UnicastUseGroupEnabled MIB object is TRUE. The miniport driver must set this MIB object to its default if any of the following occurs:

  • The miniport driver's MiniportInitializeEx function is called.

  • A method request of OID_DOT11_RESET_REQUEST is made to reset the media access control (MAC) layer of the 802.11 station and the bSetDefaultMIB member of the DOT11_RESET_REQUEST structure is TRUE.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Windot11.h (include Ndis.h)

See also

Native 802.11 Wireless LAN OIDs