NDIS_802_11_SSID
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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 |