Ping Method

Surcharge 1

Syntaxe

procedure Ping(const aText: String = '');

Paramètres

Nom	Type	Description
aText	const String	Charge utile optionnelle à transporter dans la trame ping ; passez une chaîne vide pour envoyer un ping sans charge utile.

Remarques

Cette surcharge déclenche le ping et retourne immédiatement, sans bloquer l'appelant ni attendre le pong correspondant. C'est une opération sans effet lorsque le client n'est pas connecté. Tout pong reçu du serveur est délivré de manière asynchrone via les événements de connexion standard. Les exceptions internes sont interceptées et acheminées vers OnError. Utilisez la surcharge avec délai d'attente de l'autre surcharge lorsque vous avez besoin de confirmer que le pair est toujours joignable.

Exemple

oClient.Ping('keepalive');

Surcharge 2

Syntaxe

function Ping(aTimeout: Integer; const aText: String = '') : Boolean;

Paramètres

Nom	Type	Description
aTimeout	Integer	Temps maximum en millisecondes pour attendre la réponse pong avant d'abandonner.
aText	const String	Charge utile optionnelle à transporter dans la trame ping ; passez une chaîne vide pour envoyer un ping sans charge utile.

Valeur de retour

True si le serveur a répondu avec un pong correspondant dans la fenêtre de délai ; False sinon. Lorsque False est retourné, le client peut choisir de fermer la connexion car le pair est considéré comme inaccessible. (Boolean)

Remarques

Cette surcharge bloque le thread appelant jusqu'à ce que le pong arrive ou que le délai s'écoule, elle est donc utile pour les vérifications de disponibilité interactives. La méthode retourne False immédiatement lorsque le client n'est pas connecté. Les exceptions levées par le socket sous-jacent sont interceptées et transmises à OnError. Pour un ping non bloquant, utiliser l'autre surcharge à la place.

Exemple

if not oClient.Ping(5000, 'healthcheck') then
  oClient.Disconnect;