Dot11ExtSetKeyMappingKey (Compact 2013)

3/26/2014

The IHV Extensions DLL calls this function to add or delete a cipher key from the key-mapping key tables of the wireless LAN (WLAN) adapter.

Syntax

DWORD WINAPI  Dot11ExtSetDefaultKey(
    HANDLE hDot11SvcHandle,
    PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE pKey
);

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.

• pKey
  [in] A pointer to a DOT11_CIPHER_KEY_MAPPING_KEY_VALUE structure. This 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

Header

wlanihv.h

See Also

Reference

Native 802.11 IHV Extensibility Functions
Dot11ExtIhvInitAdapter
DOT11_CIPHER_KEY_MAPPING_KEY_VALUE
OID_DOT11_CIPHER_KEY_MAPPING_KEY
Native 802.11 IHV Extensions DLL