WiFiStatus (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Required permissions

WINDEV

WEBDEV

WINDEV Mobile

Others

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 feature is no longer available.

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.

This function is now available in Browser code.

New in version 19

This function is now available for iPhone/iPad applications.

This function is now available in Browser code.

This function is now available for iPhone/iPad applications.

This function is now available in Browser code.

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:
wifiEnabled The Wi-Fi is enabled on the device.
wifiActivationInProgress The Wi-Fi is being enabled on the device.
This constant is not available.
wifiDisabled The Wi-Fi is disabled on the device.
wifiDeactivationInProgress The Wi-Fi is being disabled on the device.
This constant is not available.
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(<Procedure name>)

<Procedure name>: Character string (with or without quotes)

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

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