Dot11ExtSetKeyMappingKey function

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 Dot11ExtSetKeyMappingKey function to add or delete a cipher key from the key-mapping key tables of the wireless LAN (WLAN) adapter. For more information about these key types, see 802.11 Cipher Key Types.

Syntax


DWORD APIENTRY Dot11ExtSetKeyMappingKey(
  _In_opt_ HANDLE                              hDot11SvcHandle,
  _In_     PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE pKey
);

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.

pKey [in]

A pointer to a DOT11_CIPHER_KEY_MAPPING_KEY_VALUE structure, which defines the cipher key.

Return value

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

Remarks

A key-mapping cipher key is deleted from the adapter's key tables if the bDelete member of the DOT11_CIPHER_KEY_MAPPING_KEY_VALUE structure is set to TRUE.

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

Requirements

Target platform

Version

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

Header

Wlanihv.h (include Wlanihv.h)

See also

802.11 Cipher Key Types
DOT11_CIPHER_KEY_MAPPING_KEY_VALUE
Dot11ExtIhvInitAdapter
OID_DOT11_CIPHER_KEY_MAPPING_KEY

 

 

Send comments about this topic to Microsoft

Show: