Ping Método

Sobrecarga 1

Sintaxis

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

Parámetros

Nombre	Tipo	Descripción
aText	const String	Carga útil opcional a incluir en el frame de ping; pase una cadena vacía para enviar un ping sin carga útil.

Observaciones

Esta sobrecarga envía el ping y retorna de inmediato, sin bloquear al llamador ni esperar el pong correspondiente. No tiene efecto cuando el cliente no está conectado. Cualquier pong recibido del servidor se entrega de forma asíncrona a través de los eventos de conexión estándar. Internamente, las excepciones se capturan y se enrutan a OnError. Utilice la sobrecarga con tiempo de espera de la otra sobrecarga cuando necesite confirmar que el par sigue siendo accesible.

Ejemplo

oClient.Ping('keepalive');

Sobrecarga 2

Sintaxis

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

Parámetros

Nombre	Tipo	Descripción
aTimeout	Integer	Tiempo máximo en milisegundos para esperar la respuesta pong antes de abandonar.
aText	const String	Carga útil opcional a incluir en el frame de ping; pase una cadena vacía para enviar un ping sin carga útil.

Valor de Retorno

True si el servidor respondió con un pong coincidente dentro del intervalo de tiempo de espera; False en caso contrario. Cuando se devuelve False, el cliente puede optar por cerrar la conexión porque se considera que el par es inaccesible. (Boolean)

Observaciones

Esta sobrecarga bloquea el hilo llamante hasta que llega el pong o se agota el tiempo de espera, por lo que es útil para comprobaciones de disponibilidad interactivas. El método devuelve False inmediatamente cuando el cliente no está conectado. Las excepciones lanzadas por el socket subyacente son capturadas y redirigidas a OnError. Para un ping sin bloqueo que no espera respuesta, use la otra sobrecarga en su lugar.

Ejemplo

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