NET_Ping

4D v20 R8

NET_Ping


NET_Ping ( nomeServidor ; texto ; ativo ; timeout ) -> Resultado

Parâmetro	Tipo	Descrição
nomeServidor	String	Nome ou direção IP do servidor
texto	Texto	Texto a enviar no "ping"
ativo	Inteiro	1 = Ativo, 0 = Timeout/Inativo
timeout	Inteiro	Número de segundos de espera, 0 = utilizar o valor IT_SetTimeOut
Resultado	Inteiro	Código de erro

Descrição

O comando NET_Ping oferece um mecanismo para verificar que um endereço IP remoto está ativo. Se a máquina de fazer ping está executando o protocolo TCP/IP e a rede entre os dois sites é funcional, se devolve o estado 'Ativo'. Geralmente, a máquina ping não oferece nenhuma indicação a seu usuário de atividade, assumindo que a máquina pode responder as petições ping (ICMP Echo).

NET_Ping fará ping a uma máquina especificada por um nome de servidor ou a direção IP. Toda máquina com uma direção IP acessível através da rede pode receber um ping. Isto inclui as máquinas dos usuários finais. (Alguns sistemas de segurança por exemplo firewalls podem obstaculizar o ping das máquinas sob sua proteção.)

nomeServidor é o nome do servidor ou a direção IP da máquina a qual deve ser feito um ping.

texto é o texto a enviar no ping. O parâmetro texto só existe para dar tamanho ao pacote TCP enviado durante a execução do comando.

ativo devolve um inteiro que corresponde ao estado da máquina de fazer ping. Um valor de 1 indica que a máquina está ativa. Um valor de zero indica que a máquina está inativa ou o comando superou o tempo de espera antes de receber uma resposta.

timeout especifica o número de segundos que este comando esperará para que termine o ping. Este é um parâmetro opcional, se não passado, seu valor por padrão é zero. Um valor de zero neste parâmetro fará que seja utilizado o valor de timeout especificado pelo comando IT_SetTimeOut.

Nota: Em Windows, NET_Ping pode exigir que 4D seja lançado em modo administrador. Se esse não for o caso, o procedimento pode falhar e retornar um código de erro -10013 ("permission denied").

Ver também

IT_SetTimeOut