ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / WiFi functions
  • Special cases
  • Required permissions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Returns the list of Wi-Fi networks configured on the device.
AndroidAndroid Widget 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.
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>: Network identifier. 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:
    wifiSecurityIEEE8021XSecurity that uses the IEEE 802.1x standard.
    wifiSecurityNoneNo security is used.
    wifiSecurityWEPSecurity based on a WEP key (Wired Equivalent Privacy).
    wifiSecurityWPA2Security that uses the WPA2 mechanism (Wi-Fi Protected Access).
    wifiSecurityWPASecurity that uses the WPA mechanism (Wi-Fi Protected Access).
    wifiSecurityWPA_EAPSecurity that uses the WPA (Wi-Fi Protected Access) and EAP (Extensible Authentication Protocol) mechanisms.
iPhone/iPad 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 as 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.
  • AndroidAndroid Widget The Wi-Fi must be enabled on the device in order to retrieve the list of networks. Otherwise, the function will fail: to get more details on the error, use ErrorInfo.
AndroidAndroid Widget

Required permissions

Calling this function changes 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: wd290com.dll
Minimum version required
  • Version 16
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 11/24/2022

Send a report | Local help