4D Doc Center : NET

4D Internet Commands v14

NET_Ping


NET_Ping ( nomServeur ; texte ; actif ; timeOut ) -> Résultat

Paramètre	Type	Description
nomServeur	Chaîne	Nom ou adresse IP du serveur
texte	Texte	Texte à envoyer dans le "ping"
actif	Entier	1 = Actif, 0 = Timeout/Inactif
timeOut	Entier	Nombre de secondes d'attente, 0 = utiliser la valeur IT_SetTimeOut
Résultat	Entier	Code d'erreur

Description

La commande NET_Ping permet d'interroger une adresse IP distante pour vérifier qu'elle est active. Si la machine sondée exploite le protocole TCP/IP et si le réseau entre les deux sites est opérationnel, le statut 'Actif' est renvoyé.

Toute machine ayant une adresse IP accessible via le réseau mondial peut être sondée, y compris celles des utilisateurs finaux (toutefois, certains systèmes de sécurité appelés "firewalls" peuvent empêcher le sondage des machines placées sous leur protection).

Le paramètre nomServeur contient le nom de serveur ou l'adresse IP de la machine à sonder.

Le paramètre texte contient le texte à envoyer dans le "ping". Ce paramètre permet uniquement d'agir sur la taille du paquet TCP envoyé lors de l'exécution de la commande.

Le paramètre actif retourne un code indiquant l'état de la machine sondée. S'il reçoit la valeur 1, l'ordinateur est actif. S'il reçoit la valeur 0 (zéro), l'ordinateur est inactif ou la commande a dépassé le délai autorisé (timeout) sans recevoir de réponse.

Le paramètre timeOut spécifie le nombre maximum de secondes alloué pour l'exécution de la commande NET_Ping. Si ce paramètre est omis ou si vous passez 0, la valeur de timeout spécifiée par la commande IT_SetTimeOut sera utilisée.

Note : Le paramètre timeOut est ignoré sous Windows 95/98 et Millenium.