InternetConnected (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Firewall

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HTTP functions

InternetConnected (Function)

In french: InternetConnecté

Defines whether an Internet connection is enabled on the current computer.

Versions 19 and later

Allows you to be notified when the status of the Internet connection changes.

New in version 19

Allows you to be notified when the status of the Internet connection changes.

Versions 17 and later

This function is now available for the Android applications.

New in version 17

This function is now available for the Android applications.

Versions 18 and later

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

New in version 18

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

This function is now available in Windows Store apps mode.

This function is now available in Android Widget mode.

Versions 19 and later

This function is now available for the iPhone/iPad applications.

New in version 19

This function is now available for the iPhone/iPad applications.

Versions 20 and later

This function is now available for the Windows Phone applications.

New in version 20

This function is now available for the Windows Phone applications.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

// Active Internet connection?
ResConnection = InternetConnected()
IF ResConnection = True THEN
Info("An Internet connection is enabled")
ELSE
Info("No Internet connection is enabled")
END

Syntax

Finding out whether an Internet connection is enabled Hide the details

<Result> = InternetConnected()

<Result>: Boolean

True if an Internet connection is enabled on the current computer,
False otherwise.

Versions 19 and later

Asking for a notification when the status of the Internet connection changes Hide the details

<Result> = InternetConnected([<Procedure Name>])

<Result>: Boolean

True if the procedure was associated with InternetConnected,
False otherwise.

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

WLangage procedure ("callback" procedure) called when the status of Internet connection changes.
This procedure has the following format:

PROCEDURE <Procedure Name>(<Status>)

<Status> is an integer constant corresponding to the new status of the Internet connection.
It can take the following values:
networkDisconnected The network is disconnected or inaccessible.
networkEthernet The Internet connection is performed by Ethernet.
networkMobile The Internet connection is performed in mobile mode: edge, 2G, 3G, 4G, ...
networkWifi The Internet connection is performed by Wi-Fi.

If <Procedure Name> corresponds to an empty string (""), the WLanguage procedure that was defined beforehand will not be called anymore.

New in version 19

Asking for a notification when the status of the Internet connection changes Hide the details

<Result> = InternetConnected([<Procedure Name>])

<Result>: Boolean

True if the procedure was associated with InternetConnected,
False otherwise.

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

WLangage procedure ("callback" procedure) called when the status of Internet connection changes.
This procedure has the following format:

PROCEDURE <Procedure Name>(<Status>)

<Status> is an integer constant corresponding to the new status of the Internet connection.
It can take the following values:
networkDisconnected The network is disconnected or inaccessible.
networkEthernet The Internet connection is performed by Ethernet.
networkMobile The Internet connection is performed in mobile mode: edge, 2G, 3G, 4G, ...
networkWifi The Internet connection is performed by Wi-Fi.

If <Procedure Name> corresponds to an empty string (""), the WLanguage procedure that was defined beforehand will not be called anymore.

Asking for a notification when the status of the Internet connection changes Hide the details

<Result> = InternetConnected([<Procedure Name>])

<Result>: Boolean

True if the procedure was associated with InternetConnected,
False otherwise.

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

WLangage procedure ("callback" procedure) called when the status of Internet connection changes.
This procedure has the following format:

PROCEDURE <Procedure Name>(<Status>)

<Status> is an integer constant corresponding to the new status of the Internet connection.
It can take the following values:
networkDisconnected The network is disconnected or inaccessible.
networkEthernet The Internet connection is performed by Ethernet.
networkMobile The Internet connection is performed in mobile mode: edge, 2G, 3G, 4G, ...
networkWifi The Internet connection is performed by Wi-Fi.

If <Procedure Name> corresponds to an empty string (""), the WLanguage procedure that was defined beforehand will not be called anymore.

Remarks

Firewall

InternetConnected uses a ping request in order to check the access to Internet. Therefore, the ping must be allowed by the security parameters of the network in order for the result of the function to be pertinent.

Note: The ping is performed on the Google DNS (6 seconds, 1 attempt). The equivalent code is:

Ping("8.8.8.8", 6000, 1)

Versions 17 and later

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

Required permission : ACCESS_NETWORK_STATE: this permission allows the applications to access information regarding the networks.

New in version 17

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

Required permission : ACCESS_NETWORK_STATE: this permission allows the applications to access information regarding the networks.

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

Required permission : ACCESS_NETWORK_STATE: this permission allows the applications to access information regarding the networks.

Versions 19 and later

Change of connection status (syntax 2)

Call to the procedure:
- The WLanguage procedure is called only when the network status changes. It is not called during the call to InternetConnected. You must call InternetConnected (without parameter) to find out whether the Internet connection is enabled or not.
- The WLanguage procedure is automatically called during the call to InternetConnected.
A single procedure can be associated with InternetConnected. If InternetConnected is called several times with different procedure names, the procedure used for detecting the status of the Internet connection will be replaced by the new specified procedure.
If InternetConnected is called from a secondary thread, the procedure will be called in the main thread of the application.

New in version 19

Change of connection status (syntax 2)

Call to the procedure:
- The WLanguage procedure is called only when the network status changes. It is not called during the call to InternetConnected. You must call InternetConnected (without parameter) to find out whether the Internet connection is enabled or not.
- The WLanguage procedure is automatically called during the call to InternetConnected.
A single procedure can be associated with InternetConnected. If InternetConnected is called several times with different procedure names, the procedure used for detecting the status of the Internet connection will be replaced by the new specified procedure.
If InternetConnected is called from a secondary thread, the procedure will be called in the main thread of the application.

Change of connection status (syntax 2)

Call to the procedure:
- The WLanguage procedure is called only when the network status changes. It is not called during the call to InternetConnected. You must call InternetConnected (without parameter) to find out whether the Internet connection is enabled or not.
- The WLanguage procedure is automatically called during the call to InternetConnected.
A single procedure can be associated with InternetConnected. If InternetConnected is called several times with different procedure names, the procedure used for detecting the status of the Internet connection will be replaced by the new specified procedure.
If InternetConnected is called from a secondary thread, the procedure will be called in the main thread of the application.

Component : wd240com.dll