NET_Ping

4D v20 R7

NET_Ping


NET_Ping ( nomServidor ; texto ; activo ; timeout ) -> resultado

Parámetro	Tipo	Descripción
nomServidor	Cadena	Nombre o dirección IP del servidor
texto	Texto	Texto a enviar en el "ping"
activo	Entero	1 = Activo, 0 = Timeout/Inactivo
timeout	Entero	Número de segundos de espera, 0 = utilizar el valor IT_SetTimeOut
resultado	Entero	Código de error

Descripción

El comando NET_Ping ofrece un mecanismo para verificar que una dirección IP remota está activa. Si la máquina de hacer ping está ejecutando el protocolo TCP/IP y la red entre los dos sitios es funcional, se devuelve el estado 'Activo'. Por lo general, la máquina ping no ofrece ninguna indicación a su usuario de la actividad, asumiendo que la máquina puede responder a las peticiones ping (ICMP Echo).

NET_Ping hará ping a un equipo especificado por un nombre de servidor o la dirección IP. Toda máquina con una dirección IP accesible a través de la red puede recibir un ping. Esto incluye las máquinas de los usuarios finales. (Algunos sistemas de seguridad por ejemplo firewalls pueden obstaculizar el ping de las máquinas bajo su protección.)

nomServidor es el nombre del servidor o la dirección IP de la máquina a la cual se le debe hacer ping.

texto es el texto a enviar en el ping. El parámetro texto sólo existe para dar tamaño al paquete TCP enviado durante la ejecución del comando.

activo devuelve un entero que corresponde al estado de la máquina de hacer ping. Un valor de 1 indica que el equipo está activo. Un valor de cero indica que el equipo está inactivo o el comando superó el tiempo de espera antes de recibir una respuesta.

timeout especifica el número de segundos que este comando esperará para que termine el ping. Este es un parámetro opcional, si no se pasa, su valor por defecto es cero. Un valor de cero en este parámetro hará que se utilice el valor de timeout especificado por el comando IT_SetTimeOut.

Nota: en Windows, NET_Ping puede requerir que 4D se inicie en modo administrador. Si no es el caso, puede fallar el procedimiento y devolver un código de error -10013 ("permiso denegado").

Ver también

IT_SetTimeOut