IPStatus IPStatus IPStatus IPStatus Enum

Definición

Notifica el estado del envío de un mensaje de eco ICMP (Protocolo de mensajes de control de Internet) a un equipo.Reports the status of sending an Internet Control Message Protocol (ICMP) echo message to a computer.

public enum class IPStatus
public enum IPStatus
type IPStatus = 
Public Enum IPStatus
Herencia

Campos

BadDestination BadDestination BadDestination BadDestination 11018

Se ha producido un error en la solicitud de eco ICMP porque la dirección IP de destino no puede recibir solicitudes de eco ICMP o no debe aparecer nunca en el campo de dirección de destino de ningún datagrama IP.The ICMP echo request failed because the destination IP address cannot receive ICMP echo requests or should never appear in the destination address field of any IP datagram. Por ejemplo, cuando se llama a Send y se especifica la dirección IP "000.0.0.0", se devuelve este estado.For example, calling Send and specifying IP address "000.0.0.0" returns this status.

BadHeader BadHeader BadHeader BadHeader 11042

Se ha producido un error en la solicitud de eco ICMP porque el encabezado no es válido.The ICMP echo request failed because the header is invalid.

BadOption BadOption BadOption BadOption 11007

Se ha producido un error en la solicitud de eco ICMP porque contiene una opción que no es válida.The ICMP echo request failed because it contains an invalid option.

BadRoute BadRoute BadRoute BadRoute 11012

Se ha producido un error en la solicitud de eco ICMP porque no hay ninguna ruta válida entre los equipos de origen y de destino.The ICMP echo request failed because there is no valid route between the source and destination computers.

DestinationHostUnreachable DestinationHostUnreachable DestinationHostUnreachable DestinationHostUnreachable 11003

Se ha producido un error en la solicitud de eco ICMP porque no se ha podido alcanzar el equipo de destino.The ICMP echo request failed because the destination computer is not reachable.

DestinationNetworkUnreachable DestinationNetworkUnreachable DestinationNetworkUnreachable DestinationNetworkUnreachable 11002

Se ha producido un error en la solicitud de eco ICMP porque no se ha podido alcanzar la red que contiene el equipo de destino.The ICMP echo request failed because the network that contains the destination computer is not reachable.

DestinationPortUnreachable DestinationPortUnreachable DestinationPortUnreachable DestinationPortUnreachable 11005

Se ha producido un error en la solicitud de eco ICMP porque el puerto del equipo de destino no está disponible.The ICMP echo request failed because the port on the destination computer is not available.

DestinationProhibited DestinationProhibited DestinationProhibited DestinationProhibited 11004

Se ha producido un error en la solicitud de eco ICMPv6 porque el contacto con el equipo de destino está prohibido desde el punto de vista administrativo.The ICMPv6 echo request failed because contact with the destination computer is administratively prohibited. Este valor solo se aplica a IPv6.This value applies only to IPv6.

DestinationProtocolUnreachable DestinationProtocolUnreachable DestinationProtocolUnreachable DestinationProtocolUnreachable 11004

Se ha producido un error en la solicitud de eco ICMP porque no se ha podido alcanzar el equipo de destino especificado en un mensaje de eco ICMP debido a que no admite el protocolo del paquete.The ICMP echo request failed because the destination computer that is specified in an ICMP echo message is not reachable, because it does not support the packet's protocol. Este valor solo se aplica a IPv4.This value applies only to IPv4. Este valor se describe en IETF RFC 1812 como una comunicación prohibida administrativamente.This value is described in IETF RFC 1812 as Communication Administratively Prohibited.

DestinationScopeMismatch DestinationScopeMismatch DestinationScopeMismatch DestinationScopeMismatch 11045

Se ha producido un error en la solicitud de eco ICMP porque la dirección de origen y de destino especificadas en un mensaje de eco ICMP no se encuentran en el mismo ámbito.The ICMP echo request failed because the source address and destination address that are specified in an ICMP echo message are not in the same scope. Esto último suele producirse porque un enrutador que reenvía un paquete utiliza una interfaz que se encuentra fuera del ámbito de la dirección de origen.This is typically caused by a router forwarding a packet using an interface that is outside the scope of the source address. Los ámbitos de las direcciones (ámbito local de vínculo, ámbito local de sitio y ámbito global) determinan los lugares de la red en los que una dirección es válida.Address scopes (link-local, site-local, and global scope) determine where on the network an address is valid.

DestinationUnreachable DestinationUnreachable DestinationUnreachable DestinationUnreachable 11040

Se ha producido un error en la solicitud de eco ICMP porque no se ha podido alcanzar el equipo de destino especificado en un mensaje de eco ICMP; se desconoce la causa exacta del problema.The ICMP echo request failed because the destination computer that is specified in an ICMP echo message is not reachable; the exact cause of problem is unknown.

HardwareError HardwareError HardwareError HardwareError 11008

Se ha producido un error en la solicitud de eco ICMP debido a un error de hardware.The ICMP echo request failed because of a hardware error.

IcmpError IcmpError IcmpError IcmpError 11044

Se ha producido un error en la solicitud de eco ICMP debido a un error de protocolo ICMP.The ICMP echo request failed because of an ICMP protocol error.

NoResources NoResources NoResources NoResources 11006

Se ha producido un error en la solicitud de eco ICMP porque los recursos de red son insuficientes.The ICMP echo request failed because of insufficient network resources.

PacketTooBig PacketTooBig PacketTooBig PacketTooBig 11009

Se ha producido un error en la solicitud de eco ICMP porque el paquete que contiene la solicitud es mayor que la unidad de transmisión máxima (MTU) de un nodo (enrutador o puerta de enlace) situado entre el origen y el destino.The ICMP echo request failed because the packet containing the request is larger than the maximum transmission unit (MTU) of a node (router or gateway) located between the source and destination. La MTU define el tamaño máximo de un paquete transmisible.The MTU defines the maximum size of a transmittable packet.

ParameterProblem ParameterProblem ParameterProblem ParameterProblem 11015

Se ha producido un error en la solicitud de eco ICMP porque un nodo (enrutador o puerta de enlace) ha encontrado problemas durante el procesamiento del encabezado del paquete.The ICMP echo request failed because a node (router or gateway) encountered problems while processing the packet header. Este estado tiene lugar cuando el encabezado contiene datos de campo que no son válidos o una opción no reconocida, por ejemplo.This is the status if, for example, the header contains invalid field data or an unrecognized option.

SourceQuench SourceQuench SourceQuench SourceQuench 11016

Se ha producido un error en la solicitud de eco ICMP porque se ha descartado el paquete.The ICMP echo request failed because the packet was discarded. Esto último ocurre cuando el espacio de almacenamiento de la cola de salida del equipo de origen es insuficiente, o cuando los paquetes llegan al destino demasiado rápido como para que se procesen.This occurs when the source computer's output queue has insufficient storage space, or when packets arrive at the destination too quickly to be processed.

Success Success Success Success 0

La solicitud de eco ICMP se ha efectuado correctamente; se ha recibido una respuesta de eco ICMP.The ICMP echo request succeeded; an ICMP echo reply was received. Cuando se obtiene este código de estado, el resto de las propiedades de PingReply contienen datos válidos.When you get this status code, the other PingReply properties contain valid data.

TimedOut TimedOut TimedOut TimedOut 11010

La respuesta de eco ICMP no se ha recibido en el tiempo asignado.The ICMP echo Reply was not received within the allotted time. El intervalo de tiempo predeterminado permitido para las respuestas es de cinco segundos.The default time allowed for replies is 5 seconds. Puede cambiar este valor mediante los métodos Send o SendAsync que toman un parámetro timeout.You can change this value using the Send or SendAsync methods that take a timeout parameter.

TimeExceeded TimeExceeded TimeExceeded TimeExceeded 11041

Se ha producido un error en la solicitud de eco ICMP porque su valor TTL (período de vida) ha alcanzado el cero, lo que ha provocado que el nodo de reenvío (enrutador o puerta de enlace) haya descartado el paquete.The ICMP echo request failed because its Time to Live (TTL) value reached zero, causing the forwarding node (router or gateway) to discard the packet.

TtlExpired TtlExpired TtlExpired TtlExpired 11013

Se ha producido un error en la solicitud de eco ICMP porque su valor TTL (período de vida) ha alcanzado el cero, lo que ha provocado que el nodo de reenvío (enrutador o puerta de enlace) haya descartado el paquete.The ICMP echo request failed because its Time to Live (TTL) value reached zero, causing the forwarding node (router or gateway) to discard the packet.

TtlReassemblyTimeExceeded TtlReassemblyTimeExceeded TtlReassemblyTimeExceeded TtlReassemblyTimeExceeded 11014

Se ha producido un error en la solicitud de eco ICMP porque el paquete se ha dividido en varios fragmentos para su transmisión y no se han recibido todos los fragmentos en el tiempo asignado para el reensamblado.The ICMP echo request failed because the packet was divided into fragments for transmission and all of the fragments were not received within the time allotted for reassembly. En el documento RFC 2460 (disponible en www.ietf.org) se especifican 60 segundos como límite de tiempo para recibir todos los fragmentos del paquete.RFC 2460 (available at www.ietf.org) specifies 60 seconds as the time limit within which all packet fragments must be received.

Unknown Unknown Unknown Unknown -1

Se desconoce la razón por la que se ha producido un error en la solicitud de eco ICMP.The ICMP echo request failed for an unknown reason.

UnrecognizedNextHeader UnrecognizedNextHeader UnrecognizedNextHeader UnrecognizedNextHeader 11043

Se ha producido un error en la solicitud de eco ICMP porque el campo de encabezado siguiente no contiene un valor reconocido.The ICMP echo request failed because the Next Header field does not contain a recognized value. El campo de encabezado siguiente indica el tipo de encabezado de extensión (si existe) o el protocolo sobre la capa IP como, por ejemplo, TCP o UDP.The Next Header field indicates the extension header type (if present) or the protocol above the IP layer, for example, TCP or UDP.

Ejemplos

En el ejemplo de código siguiente se envía un mensaje de eco ICMP y comprueba el estado.The following code example sends an ICMP echo message and checks the status.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::Net::NetworkInformation;
using namespace System::Text;

// args[1] can be an IPaddress or host name.
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   
   Ping ^ pingSender = gcnew Ping;
   PingOptions ^ options = gcnew PingOptions;
   
   // Use the default Ttl value which is 128,
   // but change the fragmentation behavior.
   options->DontFragment = true;
   
   // Create a buffer of 32 bytes of data to be transmitted.
   String^ data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
   array<Byte>^buffer = Encoding::ASCII->GetBytes( data );
   int timeout = 120;
   PingReply ^ reply = pingSender->Send( args[ 1 ], timeout, buffer, options );
   
   if ( reply->Status == IPStatus::Success )
   {
      Console::WriteLine( "Address: {0}", reply->Address->ToString() );
      Console::WriteLine( "RoundTrip time: {0}", reply->RoundtripTime );
      Console::WriteLine( "Time to live: {0}", reply->Options->Ttl );
      Console::WriteLine( "Don't fragment: {0}", reply->Options->DontFragment );
      Console::WriteLine( "Buffer size: {0}", reply->Buffer->Length );
   }

   
}

using System;
using System.Net;
using System.Net.NetworkInformation;
using System.Text;

namespace Examples.System.Net.NetworkInformation.PingTest
{
    public class PingExample
    {
        // args[0] can be an IPaddress or host name.
        public static void Main (string[] args)
        {
            Ping pingSender = new Ping ();
            PingOptions options = new PingOptions ();

            // Use the default Ttl value which is 128,
            // but change the fragmentation behavior.
            options.DontFragment = true;

            // Create a buffer of 32 bytes of data to be transmitted.
            string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
            byte[] buffer = Encoding.ASCII.GetBytes (data);
            int timeout = 120;
            PingReply reply = pingSender.Send (args[0], timeout, buffer, options);
            if (reply.Status == IPStatus.Success)
            {
                Console.WriteLine ("Address: {0}", reply.Address.ToString ());
                Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);
                Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);
                Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);
                Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);
            }
        }
    }
}

Comentarios

El Ping clase utiliza los valores de esta enumeración para establecer el PingReply.Status propiedad.The Ping class uses the values in this enumeration to set the PingReply.Status property. El Ping clase devuelve PingReply objetos al llamar a la Ping.Send o Ping.SendAsync métodos para comprobar si puede llegar a un equipo a través de la red.The Ping class returns PingReply objects when you call the Ping.Send or Ping.SendAsync methods to check whether you can reach a computer across the network.

Advertencia

Los valores de enumeración DestinationProhibited y DestinationProtocolUnreachable tienen el mismo valor numérico.The DestinationProhibited and DestinationProtocolUnreachable enumeration values have the same numeric value. Esto es posible porque DestinationProhibited solo se aplica a IPv6 y DestinationProtocolUnreachable solo se aplica a IPv4.This is possible because DestinationProhibited applies only to IPv6 and DestinationProtocolUnreachable applies only to IPv4.

Se aplica a