Dot11ExtSetMulticastCipherAlgorithm (Compact 2013)

3/26/2014

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

Syntax

DWORD WINAP  Dot11ExtSetMulticastCipherAlgorithm(
    HANDLE  hDot11SvcHandle,
    DWORD  dwMulticastCipherAlgo
);

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.

• dwMulticastCipherAlgo
  [in] A DOT11_CIPHER_ALGORITHM enumerator value that identifies the multicast 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. This includes key management and replay protection, over a basic service set (BSS) network connection through the WLAN adapter.

  Note

  The value of dwMulticastCipherAlgo must match the value of a cipher algorithm returned by the Native 802.11 miniport driver through 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

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvInitAdapter
OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR
OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR
Native 802.11 IHV Extensions DLL

Other Resources

DOT11_CIPHER_ALGORITHM