Share via

Dot11ExtSetExcludeUnencrypted (Compact 7)

  • Article

3/12/2014

The IHV Extensions DLL calls this function to enable or disable the wireless LAN (WLAN) adapter from excluding unencrypted packets it receives while enabled for cipher operations.

Syntax

DWORD WINAPI Dot11ExtSetExcludeUnencrypted(
    HANDLE  hDot11SvcHandle,
    BOOL  bExcludeUnencrypted
);

Parameters

  • hDot11SvcHandle
    [in] The handle that is used by the operating system to reference the WLAN adapter. This handle value was specified through a previous call to the Dot11ExtIhvInitAdapter IHV Handler function.
  • bExcludeUnencrypted
    [in] A Boolean value that, if set to TRUE, configures the WLAN adapter to exclude unencrypted packets.

Return Value

If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.

Remarks

If the WLAN adapter is enabled to exclude unencrypted packets, the station must exempt received packets that match an entry in the station’s current EtherType exemption list. The IHV Extensions DLL specifies the EtherType exemption list through calls to the Dot11ExtSetEtherTypeHandling Handling function.

A call to the Dot11ExtSetExcludeUnencrypted function results in a set request of the OID_DOT11_EXCLUDE_UNENCRYPTED object identifier (OID) to the Native 802.11 miniport driver that manages the WLAN adapter.

Requirements

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvInitAdapter
Dot11ExtSetEtherTypeHandling
OID_DOT11_EXCLUDE_UNENCRYPTED
Native 802.11 IHV Extensions DLL