NDIS_802_11_SSID (Windows Embedded CE 6.0)

1/6/2010

OID_802_11_SSID uses this structure when it requests a miniport driver to set or return the NIC service set identifier (SSID) value.

Syntax

typedef struct _NDIS_802_11_SSID {
  ULONG SsidLength;
  UCHAR Ssid [32];
} NDIS_802_11_SSID, *PNDIS_802_11_SSID;

Members

  • SsidLength
    Specifies the length of the Ssid member in octets.
  • Ssid
    Specifies the SSID. An empty string (that is, a string with the first byte set to zero) requests the 802.11 NIC to associate with any available SSID.

Remarks

When set, the OID_802_11_SSID object identifier requests the miniport driver to set its NIC's service set identifier (SSID) to a specified value. The SSID identifies a group of interconnected basic service sets. Setting an SSID results in:

  • Disassociating the NIC from any SSID with which it might be associated.
  • Turning on the radio if the radio is OFF.
  • Setting the SSID with the specified value or setting it to any SSID if the SSID is not specified.
  • Attempting to associate the NIC with the new SSID.

When queried, this object identifier requests the miniport driver to return the SSID with which its NIC is associated. If the NIC is not associated with SSID, the miniport driver returns the value from the last OID_802_11_SSID set or, if that was an empty string, it returns the SSID of the last access point with which the NIC was associated.

Requirements

Header ntddndis.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

NDIS Structures
OID_802_11_SSID