.Activescan Method

Top  Previous  Next

Function:

Causes the Wi-Fi interface to commence either the active detection of available wireless networks or obtainment of an additional information about a particular network specified by its SSID (name).

Syntax:

wln.activescan(byref ssid as string) as accepted_rejected

Returns:

One of accepted_rejected constants:

0- ACCEPTED.

1- REJECTED.

See Also:

Scanning for Wi-Fi Networks, Wln Tasks,

wln.scan

 


Part

Description

ssid

Network name. Leave empty to detect all available networks — after the scan, the comma-delimited list of networks will be in wln.scanresultssid. Alternatively, specify the network name. If the network is detected, its parameters will be available through wln.scanresultssid, wln.scanresultbssid, wln.scanresultbssmode, wln.scanresultchannel, wln.scanresultrssi, wln.scanresultwpainfo.

Details

Active scanning process is a task and there is a certain correct way of handling tasks.

Scanning while the Wi-Fi interface is in the associated state (wln.associationstate= 1- PL_WLN_ASSOCIATED) or running its own ad-hoc network (wln.associationstate= 2- PL_WLN_OWN_NETWORK) will temporarily disrupt communications between the device and the "current" access point.

Active detection of networks is performed only on allowed channels, as determined by the wln.domain property. This is because an active "probe" signal is transmitted during the active scanning.

Active scanning can detect a networks that doesn't broadcast its SSID, but you still need to know this network's name in advance.