Home | Sign in | English EN
  • Special cases
  • Required permissions
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Adds a new network to the list of Wi-Fi networks configured on the device. Then, WiFiConnect is used to connect the device to the added Wi-Fi network.
Remark: The Wi-Fi access is not available in the Android emulator.
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.
Versions 18 and later
Android Widget This function is now available in Android widget mode.
New in version 18
Android Widget This function is now available in Android widget mode.
Android Widget This function is now available in Android widget mode.
Identifier is string
Identifier = WiFiAddNetwork("SSID", "BSSID", wifiSecurityWPA, "pwd", True)
IF Identifier <> " "  THEN
<Result> = WiFiAddNetwork(<SSID> , <BSSID> , <Security> [, <Key> [, <Permanent>]])
<Result>: Character string
  • Network identifier of the new network.
  • Empty string if the network was not created. ErrorInfo returns more information on the error.
Remark: If the added network corresponds to a network that is already configured on the device, <Result>corresponds to the identifier of the existing network.
<SSID>: Character string
SSID (Service Set Identifier) of Wi-Fi network.
<BSSID>: Character string
BSSID (Basic Service Set Identifier) of the access point associated with the network.
<Security>: Character String constant
Type of security used by the Wi-Fi network:
wifiSecurityIEEE8021XSecurity that is using the IEEE 802.1x standard.
wifiSecurityNoneNo security is used.
wifiSecurityWEPSecurity based on a WEP key (Wired Equivalent Privacy)
wifiSecurityWPA2Security that is using the WPA2 mechanism (Wi-Fi Protected Access).
wifiSecurityWPASecurity that is using the WPA mechanism (Wi-Fi Protected Access).
wifiSecurityWPA_EAPSecurity that is using the WPA mechanism (Wi-Fi Protected Access) and the EAP mechanism (Extensible Authentication Protocol).
<Key>: Optional character string
Key used to connect to the secured network. The key is mandatory if the type of the specified security protocol is WPA or WPA2.
<Permanent>: Optional boolean
Indicates whether the addition of the network is permanent:
  • True: the added network will be permanently stored on the device.
  • False (default value): the added network will not be kept when the device is restarted.

Special cases

  • If the added network is permanently stored on the device (<Permanent> set to True), the identifiers assigned to each one of the networks can be modified after WiFiAddNetwork is executed. Use WiFiListNetwork to find out the new identifiers.
  • To delete a network from the list of networks configured on the device, use WiFiDeleteNetwork.

Required permissions

The call to this function modifies the permissions required by the application.
Required permissions :
  • ACCESS_WIFI_STATE: allows the applications to access the information regarding the Wi-Fi networks.
  • CHANGE_WIFI_STATE: allows the applications to modify the Wi-Fi connectivity status.
Related Examples:
WM System Cross-platform examples (WINDEV Mobile): WM System
[ + ] This application is an example of some of the features of WINDEV Mobile available for Android/iOS.
The following system functions are used:
- Multimedia control
- Brightness
- Volume
- Wi-Fi
- Bluetooth
- Toast
- Compass
- Accelerometer
- Camera control
- Vibration
- Notifications
- Drawing functions
- Internet
Component: wd270android.jar
Minimum version required
  • Version 16
Click [Add] to post a comment