Collecting Data About the 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
If wln.scanresultssid<>"" Then
 'network found!
End If

After the scan...

  • Wln.scanresultssid R/O 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:
  • Wln.scanresultbssid R/O property will contain the BSSID ("MAC address") of the specified network.
  • Wln.scanresultbssmode R/O property will contain the BSS mode of the network (infrastructure or ad-hoc).
  • Wln.scanresultchannel R/O property will return the number of the RF channel on which the network operates.
  • Wln.scanresultrssi R/O property will contain the strength of the RF signal received from the specified network.
  • Wln.scanresultwpainfo R/O property: If you are using GA1000, this will contain the data necessary for WPA/WPA2 protocols (this is not a human-readable data, let our WLN library interpret it). If you are using WA2000, this property will return an empty string. This is because the WA2000 handles WPA/WPA2 internally.  

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. Wln.activescan, on the contrary, 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.