OID_DOT11_UNICAST_USE_GROUP_ENABLED (Compact 2013)

3/26/2014

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 using 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

Header

windot11.h

See Also

Reference

Native 802.11 Extensible Station OIDs
OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR
OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR
MiniportInitializeEx
OID_DOT11_RESET_REQUEST
DOT11_RESET_REQUEST
Native 802.11 Wireless LAN OIDs