Edit

WLAN_BSS_LIST structure (wlanapi.h)

  • Article

The WLAN_BSS_LIST structure contains a list of basic service set (BSS) entries.

Syntax

typedef struct _WLAN_BSS_LIST {
  DWORD          dwTotalSize;
  DWORD          dwNumberOfItems;
  WLAN_BSS_ENTRY wlanBssEntries[1];
} WLAN_BSS_LIST, *PWLAN_BSS_LIST;

Members

dwTotalSize

The total size of this structure, in bytes.

dwNumberOfItems

The number of items in the wlanBssEntries member.

wlanBssEntries[1]

An array of WLAN_BSS_ENTRY structures that contains information about a BSS.

Remarks

The WlanGetNetworkBssList function retrieves the BSS list of the wireless network or networks on a given interface and returns this information in a WLAN_BSS_LIST structure.

The WLAN_BSS_LIST structure may contain padding for alignment between the dwTotalSize member, the dwNumberOfItems member, and the first WLAN_BSS_ENTRY array entry in the wlanBssEntries member. Padding for alignment may also be present between the WLAN_BSS_ENTRY array entries in the wlanBssEntries member. Any access to a WLAN_BSS_ENTRY array entry should assume padding may exist.

When the wireless LAN interface is also operating as a Wireless Hosted Network , the BSS list will contain an entry for the BSS created for the Wireless Hosted Network.

Since the information is returned by the access point for an infrastructure BSS network or by the network peer for an independent BSS network (ad hoc network), the information returned should not be trusted. The ulIeOffset and ulIeSize members in the WLAN_BSS_ENTRY structure should be used to determine the maximum size of the information element data blob in the WLAN_BSS_ENTRY structure, not the data in the information element data blob.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP3 [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header wlanapi.h
Redistributable Wireless LAN API for Windows XP with SP2

See also

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_ENTRY

WlanGetAvailableNetworkList

WlanGetNetworkBssList