Dot11ExtSetAuthAlgorithm function

The IHV Extensions DLL calls the Dot11ExtSetAuthAlgorithm function to enable an authentication algorithm on the wireless LAN (WLAN) adapter.

Syntax


DWORD APIENTRY Dot11ExtSetAuthAlgorithm(
  _In_opt_  HANDLE hDot11SvcHandle,
  _In_      DWORD dwAuthAlgo
);

Parameters

hDot11SvcHandle [in, optional]

The handle 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.

dwAuthAlgo [in]

A DOT11_AUTH_ALGORITHM enumerator value that identifies the authentication algorithm.

If the value is within the range of DOT11_AUTH_ALGO_IHV_START through DOT11_AUTH_ALGO_IHV_END, the IHV Extensions DLL enables a proprietary authentication algorithm supported by the WLAN adapter.

Otherwise, the DLL is responsible for the processing of a standard authentication algorithm supported by the operating system. In this situation, the operating system is not involved with the authentication processing over a basic service set (BSS) network connection through the WLAN adapter.

Note  The value of dwAuthAlgo must match the value of an authentication algorithm returned by the Native 802.11 miniport driver through setting the appropriate xxxAlgoPairs members of the DOT11_EXTSTA_ATTRIBUTES structure. In its MiniportInitializeEx routine, when the miniport driver calls NdisMSetMiniportAttributes, it sets the MiniportAttributes parameter to the address of driver-allocated block of memory that contains an NDIS_MINIPORT_ADAPTER_NATIVE_802_11_ATTRIBUTES structure along with the DOT11_EXTSTA_ATTRIBUTES structure. The value of dwAuthAlgo should also match the value returned by queries of OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR or OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR. However, the Dot11ExtSetAuthAlgorithm function does not issue these queries.

Return value

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

Requirements

Version

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

Header

Wlanihv.h (include Wlanihv.h)

See also

DOT11_AUTH_ALGORITHM
Dot11ExtIhvInitAdapter
Dot11ExtPreAssociateCompletion
OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR
OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft