OID_DOT11_EXCLUDE_UNENCRYPTED

  • Article

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_EXCLUDE_UNENCRYPTED OID requests that the miniport driver set the IEEE 802.11 dot11ExcludeUnencrypted management information base (MIB) object.

When queried, this OID requests that the miniport driver return the setting of the dot11ExcludeUnencrypted MIB object.

The dot11ExcludeUnencrypted MIB object specifies how the 802.11 station handles received packets with unencrypted payload data.

Note  Support for OID_DOT11_EXCLUDE_UNENCRYPTED is mandatory if the 802.11 station supports any cipher algorithms. The miniport driver returns a list of supported cipher algorithms when OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR or OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR are queried.

 

The data type for this OID is a BOOLEAN value.

The dot11ExcludeUnencrypted MIB object defines the following actions:

  • If dot11ExcludeUnencrypted is TRUE, then the 802.11 station must discard any received unicast packets in which the Protected Frame subfield of the Frame Control field in the 802.11 MAC header is set to zero.

  • If dot11ExcludeUnencrypted is FALSE, then the 802.11 station can accept these packets and indicate them to the operating system.

When dot11ExcludeUnencrypted is FALSE, the miniport driver must connect to an access point (AP) with a Wired Equivalent Privacy (WEP) profile, even if the AP does not set the privacy field in the relevant management frames.

The actions defined by the dot11ExcludeUnencrypted MIB object do not apply to received packets that match an entry in the 802.11 station's current EtherType exemption list. For more information about the EtherType exemption list, see OID_DOT11_PRIVACY_EXEMPTION_LIST.

The default setting for the dot11ExcludeUnencrypted MIB object is FALSE. The miniport driver must set the MIB object to this default through its MiniportInitializeEx function or when reset through OID_DOT11_RESET_REQUEST.

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