version 6.8.1 (Modifiée)
NET_Ping (nomServeur; texte; actif{; timeOut}) Entier
Paramètre | Type | Description | |
nomServeur | Alpha | 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.
Référence