DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM callback function (wlanihv.h)

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.

The IHV Extensions DLL calls the Dot11ExtSetUnicastCipherAlgorithm function to enable a unicast cipher algorithm on the wireless LAN (WLAN) adapter.

Syntax

DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Dot11extSetUnicastCipherAlgorithm;

DWORD Dot11extSetUnicastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwUnicastCipherAlgo
)
{...}

Parameters

[in, optional] hDot11SvcHandle

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.

[in] dwUnicastCipherAlgo

A DOT11_CIPHER_ALGORITHM enumerator value that identifies the unicast cipher algorithm.

If the value is within the range of DOT11_CIPHER_ALGO_IHV_START through DOT11_CIPHER_ALGO_IHV_END, the IHV Extensions DLL enables a proprietary cipher algorithm supported by the WLAN adapter.

Otherwise, the DLL is responsible for processing a standard cipher algorithm supported by the operating system. In this situation, the operating system is not involved with any aspect of the cipher algorithm, including key management and replay protection, over a basic service set (BSS) network connection through the WLAN adapter.

Note  The value of dwUnicastCipherAlgo must match the value of a cipher algorithm returned by the Native 802.11 miniport driver through setting the appropriate xxxAlgoPairs members of the DOT11_EXTSTA_ATTRIBUTES structure, which must match the values that would be returned by queries of OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR or OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Return value

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

Requirements

Requirement Value
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header wlanihv.h (include Wlanihv.h)

See also

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter