WiFiStatus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Communication

WiFi functions

WiFiStatus

Presentation

Example

Required permissions

See also

WiFiStatus (Function)

In french: WiFiEtat

Returns the current activation status of Wi-Fi on the device or asks to be notified when the activation status of Wi-Fi changes.

Remarks:

To enable or disable the Wi-Fi on the device, use WiFiActivate.
The Wi-Fi access is not available in the Android emulator.
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

IF WiFiStatus() = wifiDisabled THEN
WiFiActivate(True)
END

Syntax

Finding out the current activation status of Wi-Fi on the current computer Hide the details

<Result> = WiFiStatus()

<Result>: Integer

Current activation status of Wi-Fi:
wifiActivationInProgress The Wi-Fi is being enabled on the device.
This constant is not available.
wifiDeactivationInProgress The Wi-Fi is being disabled on the device.
This constant is not available.
wifiDisabled The Wi-Fi is disabled on the device.
wifiEnabled The Wi-Fi is enabled on the device.
wifiError The activation status of Wi-Fi cannot be retrieved.
This constant does not correspond to a possible option.

Enabling the notification for changes of Wi-Fi activation Hide the details

WiFiStatus(<WLanguage procedure>)

<WLanguage procedure>: Procedure name

WLanguage procedure ("callback" procedure) called when the activation status of Wi-Fi changes on the device.
This procedure has the following format :

PROCEDURE <Procedure name> (<New status>, <Former status>)

where:
<New status> is an integer corresponding ot the new activation status of Wi-Fi on the device
<Former status> is an integer corresponding to the activation status of Wi-Fi on the device before the change of status.
The parameters of this procedure are optional. There is no need to pass parameters to this procedure. Indeed, these parameters are automatically filled during each call.
If this parameter corresponds to an empty string (""), the notifications will not be sent anymore when the status changes. The function has no effect if no notification request was performed.

Remarks

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: WDJS.DLL