InternetConnected (Function)

ONLINE HELP
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 Android applications.

New in version 17

This function is now available for 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 iPhone/iPad applications.

New in version 19

This function is now available for iPhone/iPad applications.

Versions 20 and later

This function is now available for Windows Phone applications.

New in version 20

This function is now available for 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([<WLanguage procedure>])

<Result>: Boolean

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

<WLanguage procedure>: Procedure name

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 <WLanguage procedure> is an empty string (""), the previously defined WLanguage procedure will no longer be called.

New in version 19

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

<Result> = InternetConnected([<WLanguage procedure>])

<Result>: Boolean

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

<WLanguage procedure>: Procedure name

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 <WLanguage procedure> is an empty string (""), the previously defined WLanguage procedure will no longer be called.

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

<Result> = InternetConnected([<WLanguage procedure>])

<Result>: Boolean

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

<WLanguage procedure>: Procedure name

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 <WLanguage procedure> is an empty string (""), the previously defined WLanguage procedure will no longer be called.

Remarks

Firewall

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

Remark: 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 when InternetConnected is called. You must call InternetConnected (without parameters) to know whether or not the Internet connection is enabled.
- The WLanguage procedure is automatically called when InternetConnected is called.
Only one procedure can be associated with InternetConnected. If InternetConnected is called multiple times with different procedure names, the procedure used to detect the status of the Internet connection will be replaced by the last procedure specified.
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 when InternetConnected is called. You must call InternetConnected (without parameters) to know whether or not the Internet connection is enabled.
- The WLanguage procedure is automatically called when InternetConnected is called.
Only one procedure can be associated with InternetConnected. If InternetConnected is called multiple times with different procedure names, the procedure used to detect the status of the Internet connection will be replaced by the last procedure specified.
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 when InternetConnected is called. You must call InternetConnected (without parameters) to know whether or not the Internet connection is enabled.
- The WLanguage procedure is automatically called when InternetConnected is called.
Only one procedure can be associated with InternetConnected. If InternetConnected is called multiple times with different procedure names, the procedure used to detect the status of the Internet connection will be replaced by the last procedure specified.
If InternetConnected is called from a secondary thread, the procedure will be called in the main thread of the application.

Component: wd270com.dll