OID_802_11_REMOVE_KEY

When set, the OID_802_11_REMOVE_KEY OID requests that the miniport driver remove the key at a specified key index for the current association.

If the key index is invalid, the miniport driver must return NDIS_STATUS_INVALID_DATA. If the key index is valid, but no key exists at that index, the miniport driver must return NDIS_STATUS_SUCCESS.

The NDIS_802_11_REMOVE_KEY structure is defined as follows:

    typedef struct _NDIS_802_11_REMOVE_KEY {
         ULONG Length;
         ULONG KeyIndex;
         NDIS_802_11_MAC_ADDRESS BSSID;
 
    } NDIS_802_11_REMOVE_KEY, *PNDIS_802_11_REMOVE_KEY;
  

This structure includes the following members:

• Length
  The length, in bytes, of the NDIS_802_11_REMOVE_KEY structure.

• KeyIndex
  Index of the key to remove. The key index occupies the first 8 bits and ranges from 0 through 255. Bit 31 must be 0; otherwise, the miniport driver must fail the set request and return NDIS_STATUS_INVALID_DATA. If bit 30 is set to 1, the key is a pairwise key. Otherwise, the key is a group key. If the transmit key is removed for a BSSID, no transmit key exists for the key type for a BSSID, until a transmit key is specified. The remaining bits must be set to 0; otherwise, the miniport driver must fail the request and return NDIS_STATUS_INVALID_DATA.

• BSSID
  The MAC address of the BSSID that the key applies to. If the BSSID is unknown, this member is set to 0xFFFFFFFFFFFF.

  Note   If the device is associated and the BSSID member's value is the same as the associated BSSID, the miniport driver must remove the key when the device disassociates from that BSSID.

   

The following table summarizes the miniport driver's behavior that is associated with removing a key.

Key type	BSSID	Key mapping supported	Key index	What the miniport driver must do
Pairwise	Unknown	Yes	Ignored	Delete all the pairwise keys.
Pairwise	Known	Yes	Ignored	Delete the pairwise key for this BSSID.
Pairwise	Not applicable	No	Ignored	Delete group key at index 0.
Group	Unknown	Not applicable	Required	Delete all the group keys that the key index specifies.
Group	Known	Not applicable	Required	Delete the group key that the key index specifies for this BSSID.

 

 

 

Send comments about this topic to Microsoft