NDIS_802_11_WEP (Windows Embedded CE 6.0)

1/6/2010

This structure describes the key index used by a wired equivalent privacy (WEP) algorithm. OID_802_11_ADD_WEP uses this structure to request that a miniport set an 802.11 WEP key to a specified value.

Syntax

typedef struct _NDIS_802_11_WEP {
  ULONG Length;
  ULONG KeyIndex;
  ULONG KeyLength;
  UCHAR KeyMaterial[1];
} NDIS_802_11_WEP, *PNDIS_802_11_WEP;

Members

• Length
  Specifies the length of the NDIS_802_11_WEP structure in bytes.

• KeyIndex
  Specifies which key to add or remove. The global keys are represented by values of zero to n. When the most significant bit is set to 1, it indicates the key used to transmit to the access point.

• KeyLength
  Specifies the length of the KeyMaterial character array in bytes.

• KeyMaterial
  Specifies the length of the KeyMaterial character array in bytes.

Remarks

A WEP key can be a pre-shared key (a key that is provided to the NICs before use) for authentication, encryption, or both.

When OID_802_11_ADD_WEP sets the same index twice, the miniport driver should overwrite the previous WEP key at that index.

The underlying miniport driver and its NIC should not maintain WEP keys in permanent storage (disk, registry, flash or other). WEP keys should be discarded immediately after any of the following events:

• After the NIC disassociates itself from all basic service set identifiers (BSSIDs)
• If shared key authentication using the WEP key fails
• When the driver is unloaded

Requirements

See Also

Reference

NDIS Structures
OID_802_11_ADD_WEP