DOT11EXT_SET_DEFAULT_KEY - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// wlanihv.h
DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;
DWORD Dot11extSetDefaultKey(
[in, optional] HANDLE hDot11SvcHandle,
[in] PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
[in] DOT11_DIRECTION dot11Direction
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
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 Dot11ExtSetDefaultKey function to add or delete a cipher key from the default key or per-station default key tables of the wireless LAN (WLAN) adapter. For more information about these key types, see 802.11 Cipher Key Types.
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_DEFAULT_KEY_VALUE structure, which defines the cipher key.
dot11Direction [in]A DOT11_DIRECTION value that specifies whether the key can be used only for received packets (DOT11_DIR_INBOUND) or both received and sent packets (DOT11_DIR_BOTH).
Note The IHV Extensions DLL must not pass a value of DOT11_DIR_OUTBOUND to this parameter.
If the call succeeds, the function returns ERROR_SUCCESS. Otherwise, it returns an error code defined in Winerror.h.
DWORD WINAPI * Dot11ExtSetDefaultKey(
_In_opt_ HANDLE hDot11SvcHandle,
_In_ PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
_In_ DOT11_DIRECTION dot11Direction
);
A call to the Dot11ExtSetDefaultKey function results in a set request of the OID_DOT11_CIPHER_DEFAULT_KEY object identifier to the WLAN adapter.
A default cipher key is defined by setting the MacAddr member of the DOT11_CIPHER_DEFAULT_KEY_VALUE structure to a value of 0x000000000000. A per-station default cipher key is defined by setting the MacAddr member to a valid unicast media access control (MAC) address.
A cipher key is deleted from the adapter's key tables if the bDelete member of the DOT11_CIPHER_DEFAULT_KEY_VALUE structure is set to TRUE.
DOT11_CIPHER_DEFAULT_KEY_VALUE