WiFiListNetwork (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Special cases
Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

WiFiListNetwork (Function)

In french: WiFiListeRéseau

Returns the list of Wi-Fi networks configured on the device.

Caution: This feature is available up to Android 9. From Android 10, this information is no longer available: this function causes a fatal error. It is recommended to test the Android version used via SysAndroidVersion.

Versions 18 and later

This function is now available in Android Widget mode.

New in version 18

This function is now available in Android Widget mode.

Versions 19 and later

This function is now available for iPhone/iPad applications.

New in version 19

This function is now available for iPhone/iPad applications.

Example

MyList is string
nID is int
sSSID is string

MyList = WiFiListNetwork()
FOR EACH STRING Network OF MyList SEPARATED BY CR
nId = Val(ExtractString(Network, 1 , TAB)
sSSID = ExtractString(Network, 2, TAB)
...
END

Syntax

<Result> = WiFiListNetwork()

<Result>: Character string

List of networks separated by CR characters (Carriage Return) and sorted by priority order (from the one with the highest priority to the one with the lower priority). The network with the highest priority is the one chosen by the device to connect in Wi-Fi.
For each network, a set of information is returned in the following format:

<Identifier> + TAB + <SSID> + TAB + <Security>

where:
<Identifier>: Identifier of network. This identifier can then be passed as a parameter to WiFiConnect to connect to the network.
<SSID>: SSID (Service Set Identifier) of Wi-Fi network.
<Security>: Security protocol used by the network:
wifiSecurityNone No security is used.
wifiSecurityWEP Security based on a WEP key (Wired Equivalent Privacy).
wifiSecurityWPA Security that is using the WPA mechanism (Wi-Fi Protected Access).
wifiSecurityWPA2 Security that is using the WPA2 mechanism (Wi-Fi Protected Access).
wifiSecurityWPA_EAP Security that is using the WPA (Wi-Fi Protected Access) and EAP (Extensible Authentication Protocol) mechanisms.
wifiSecurityIEEE8021X Security that is using the IEEE 802.1x standard.
The security protocol is always 0.

Remarks

Special cases

To connect the device to one of the networks found in the list, use WiFiConnect and pass the identifier of the selected network in parameter.
WiFiListNetwork returns the list of Wi-Fi networks configured on the device. To find out the list of access points currently accessible from the device, use WiFiDetectAccessPoint.
The Wi-Fi must be enabled on the device in order to retrieve the list of networks. Otherwise, the function will fail: to get the details of the error, use ErrorInfo.

Required permissions

The call to this function modifies the permissions required by the application.

Required permission : ACCESS_WIFI_STATE

This permission allows the applications to access information regarding the Wi-Fi networks.

Component: wd260com.dll