InternetConnecté (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Communication / Fonctions HTTP

Firewall

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

Fonctions HTTP

InternetConnecté (Fonction)

En anglais : InternetConnected

Détermine si une connexion Internet est active sur le poste en cours.

Permet d'être notifié lors du changement d'état de la connexion Internet.

Exemple

// Connexion Internet active ?
ResConnexion = InternetConnecté()
SI ResConnexion = Vrai ALORS
Info("Une connexion Internet est active")
SINON
Info("Aucune connexion Internet n'est active")
FIN

Syntaxe

Savoir si une connexion Internet est active Masquer les détails

<Résultat> = InternetConnecté()

<Résultat> : Booléen

Vrai si une connexion Internet est active sur le poste en cours,
Faux dans le cas contraire.

Demander une notification lors d'un changement d'état de la connexion Internet Masquer les détails

<Résultat> = InternetConnecté([<Procédure WLangage>])

<Résultat> : Booléen

Vrai si la procédure a été associée à la fonction InternetConnecté,
Faux dans le cas contraire.

<Procédure WLangage> : Nom de procédure

Procédure WLangage (également nommée "callback") appelée lors d'un changement d'état de la connexion Internet.
Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Etat>)
Le paramètre <Etat> est une constante de type entier correspondant au nouvel état de la connexion Internet.
Il peut prendre les valeurs suivantes :
réseauDéconnecté Le réseau est déconnecté ou inaccessible.
réseauEthernet La connexion Internet est réalisée par Ethernet.
réseauMobile La connexion Internet est réalisée en mode mobile : edge, 2G, 3G, 4G, ...
réseauWifi La connexion Internet est réalisée par Wi-Fi.

Si le paramètre <Procédure WLangage> correspond à une chaîne vide (""), la procédure WLangage précédemment définie ne sera plus appelée.

Remarques

Firewall

La fonction InternetConnecté utilise une requête ping afin de tester l'accès à Internet. Il faut donc que les paramètres de sécurité du réseau autorise le ping pour que le résultat de la fonction soit pertinent.

Remarque : Le ping est réalisé sur le DNS de Google (6 secondes, 1 essai). Le code équivalent est :

Ping("8.8.8.8", 6000, 1)

Permissions requises
L'utilisation de cette fonction entraîne la modification des permissions requises par l'application.

Permission requise : ACCESS_NETWORK_STATE : cette permission permet aux applications d'accéder à des informations concernant les réseaux.

Changement d'état de la connexion (syntaxe 2)

Appel de la procédure :
- La procédure WLangage n'est appelée qu'en cas de changement de l'état du réseau. Elle n'est pas appelée lors de l'appel de la fonction InternetConnecté. Il est nécessaire d'appeler la fonction InternetConnecté (sans paramètre) pour savoir si la connexion Internet est active ou non.
- La procédure WLangage est automatiquement appelée lors de l'appel de la fonction InternetConnecté.
Une seule procédure peut être associée à la fonction InternetConnecté. Si la fonction InternetConnecté est appelée plusieurs fois avec des noms de procédure différents, la procédure utilisée pour la détection de l'état de la connexion Internet sera remplacée par la nouvelle procédure spécifiée.
Si la fonction InternetConnecté est appelée depuis un thread secondaire, la procédure sera appelée dans le thread principal de l'application.

Composante : wd300com.dll

Voir Aussi

Fonctions HTTP

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale