Wln_rescan()

Description:

API procedure, starts the search for the specified access point in order to obtain its signal strength.

Syntax:

function wln_rescan(byref ap_name as string) as en_wln_status_codes

Returns:

One of these en_wln_status_codes: WLN_STATUS_OK, WLN_STATUS_NOT_STARTED, WLN_STATUS_BUSY

See Also:

Step-by-step Usage Instructions, Operation Details, Roaming Between Access Points

Part

Description

ap_name

The SSID (name) of the access point to search for.

Details

The purpose of wln_rescan() is to help you find out if there is an access point in range that has a "better signal". This function starts the process, which then proceeds in the background without stalling your application. Once the scanning is finished, callback_wln_rescan_result() is called.

If several access points with the same SSID are in range, callback_wln_rescan_result() will return the signal strength for the access point with the strongest signal.

The WLN library uses active scanning (wln.activescan ) and, therefore, will be able to find access points that do not broadcast their SSIDs.

You can't use this function before calling wln_start() .