Collecting Data About a Specified Network

When called with the argument set to the name of a particular network, wln.scan and wln.activescan will attempt to find this wireless network and obtain its operating parameters:

Tibbo BASIC

							'scan for a specific network
							wln.activescan("Tibbo1") 'you could use wln.scan(''), unless you are expecting to be dealing with a hidden network
							While wln.task<>PL_WLN_TASK_IDLE
							Wend
							If wln.scanresultssid<>"" Then
								'network found!
								...
							End If
						

After the scan, the wln.scanresultssid⁽¹⁾read-only property will contain the name of the specified network, or nothing if the network wasn't found. If the network was found, the following properties will also be updated:

The wln.scanresultbssid⁽¹⁾ read-only property will contain the BSSID ("MAC address") of the specified network.
The wln.scanresultbssmode⁽¹⁾ read-only property will contain the BSS mode of the network (infrastructure or ad hoc).
The wln.scanresultchannel⁽¹⁾ read-only property will return the number of the RF channel on which the network operates.
The wln.scanresultrssi⁽¹⁾ read-only property will contain the strength of the RF signal received from the specified network.
The wln.scanresultwpainfo⁽²⁾ read-only property:

If you are using the GA1000, this will contain the data necessary for the WPA/WPA2 protocols (this is not human-readable data, let our WLN library interpret it).
If you are using the WA2000, this property will return an empty string. This is because the WA2000 handles WPA/WPA2 internally.

These properties are not available or unnecessary on the WM2000 or WS1102 when using "auto-connect" (wln.autoconnect = 1 — YES).
This property is not available on the WM2000 or WS1102.

Both wln.scan and wln.activescan will collect exactly the same data about the specified network. The only difference is that wln.scan won't be able to do the job if this wireless network does not broadcast its SSID. On the contrary, wln.activescan will get this done. So, if you need to work with a hidden network, then you need to know this network's name and you need to use wln.activescan to obtain this network's data.