WiFi Framework C++ Edition

◆ EnumBss()

int EnumBss ( const GUID &  IfaceId,
const tstring Ssid,
const wclWiFiBssType  BssType,
const bool  SecurityEnabled,
wclWiFiBssArray BssList 
)

The method retrieves a list of the basic service set (BSS) entries of the wireless network or networks on a given wireless LAN interface.

Parameters
IfaceIdThe Wireless LAN interface's ID to be queried.
SsidThe SSID of the network from which the BSS list is requested. This parameter is optional. When set to the empty string, the returned list contains all of available BSS entries on a wireless LAN interface. In addition, the BssType parameter must be set to either bssInfrastructure or bssindependent and the SecurityEnabled parameter must be specified.
BssTypeThe BSS type of the network. This parameter is ignored if the SSID of the network for the BSS list is unspecified (the Ssid parameter is the empty string).
SecurityEnabledA value that indicates whether security is enabled on the network. This parameter is only valid when the SSID of the network for the BSS list is specified (the Ssid parameter is not an empty string).
BssListA storage to receive the returned list of BSS entries. The caller is responsible to dispose the allocated memory.
Returns
If the function succeed the return value is wclCommon::WCL_E_SUCCESS. Otherwise the method returns one of the WCL error codes.

The caller is responsible to dispose the memory allocated for the dynamic array contains the BSS list.

See also
wclWiFiBssType, wclWiFiBssArray