IPStatus Enumerazione

Riferimento

Definizione

Spazio dei nomi:: System.Net.NetworkInformation

Assembly:: System.Net.Ping.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Riporta lo stato dell'invio di un messaggio echo del protocollo ICMP (Internet Control Message Protocol) a un computer.

public enum class IPStatus

public enum IPStatus

type IPStatus =

Public Enum IPStatus

Ereditarietà: Object

ValueType

Enum
IPStatus

Campi

BadDestination	11018	La richiesta echo ICMP non è riuscita perché l'indirizzo IP di destinazione non può ricevere richieste echo ICMP o perché non deve essere incluso nel campo degli indirizzi di destinazione di un datagramma IP. Ad esempio, questo stato è restituito se si chiama Send specificando come indirizzo IP "000.0.0.0".
BadHeader	11042	La richiesta echo ICMP non è riuscita perché l'intestazione non è valida.
BadOption	11007	La richiesta echo ICMP non è riuscita perché contiene un'opzione non valida.
BadRoute	11012	La richiesta echo ICMP non è riuscita perché non esiste un percorso valido fra il computer di origine e quello di destinazione.
DestinationHostUnreachable	11003	La richiesta echo ICMP non è riuscita perché il computer di destinazione non è raggiungibile.
DestinationNetworkUnreachable	11002	La richiesta echo ICMP non è riuscita perché la rete in cui si trova il computer di destinazione non è raggiungibile.
DestinationPortUnreachable	11005	La richiesta echo ICMP non è riuscita perché la porta del computer di destinazione non è disponibile.
DestinationProhibited	11004	La richiesta echo ICMPv6 non è riuscita perché il contatto con il computer di destinazione non è consentito a livello amministrativo. Questo valore si applica solo a IPv6.
DestinationProtocolUnreachable	11004	La richiesta echo ICMP non è riuscita perché il computer di destinazione specificato in un messaggio echo ICMP non è raggiungibile, in quanto non supporta il protocollo del pacchetto. Questo valore si applica solo a IPv4. Questo valore viene descritto in IETF RFC 1812 come comunicazione non consentita a livello amministrativo.
DestinationScopeMismatch	11045	La richiesta echo ICMP non è riuscita perché l'indirizzo di origine e quello di destinazione specificati in un messaggio echo ICMP non sono nello stesso ambito. Questo è causato in genere da un router che inoltra un pacchetto utilizzando un'interfaccia esterna all'ambito dell'indirizzo di origine. Gli ambiti degli indirizzi (link-local, site-local e con ambito globale) determinano i punti sulla rete in cui un indirizzo è valido.
DestinationUnreachable	11040	La richiesta echo ICMP non è riuscita perché il computer di destinazione specificato nel messaggio echo ICMP non è raggiungibile. L'origine esatta del problema è sconosciuta.
HardwareError	11008	La richiesta echo ICMP non è riuscita a causa di un errore hardware.
IcmpError	11044	La richiesta echo ICMP non è riuscita per un errore del protocollo ICMP.
NoResources	11006	La richiesta echo ICMP non è riuscita perché le risorse di rete sono insufficienti.
PacketTooBig	11009	La richiesta echo ICMP non è riuscita perché il pacchetto contenente la richiesta ha dimensioni superiori all'unità di trasmissione massima (MTU) di un nodo (router o gateway) situato fra l'origine e la destinazione. Il valore MTU definisce la dimensione massima di un pacchetto trasmissibile.
ParameterProblem	11015	La richiesta echo ICMP non è riuscita perché un nodo (router o gateway) ha riscontrato problemi nell'elaborazione dell'intestazione del pacchetto. Questo accade, ad esempio, se l'intestazione contiene dati di campo non validi o un'opzione non riconosciuta.
SourceQuench	11016	La richiesta echo ICMP non è riuscita perché il pacchetto è stato eliminato. Questo si verifica quando la coda di output del computer di origine non dispone di spazio sufficiente o quando i pacchetti arrivano a destinazione troppo rapidamente per essere elaborati.
Success	0	La richiesta echo ICMP è riuscita ed è stata ricevuta una risposta echo ICMP. Quando si riceve questo codice di stato, le altre proprietà PingReply contengono dati validi.
TimedOut	11010	La risposta echo ICMP non è stata ricevuta entro il tempo massimo consentito. Il tempo massimo predefinito per le risposte è 5 secondi. È possibile modificare questo valore utilizzando i metodi Send o SendAsync che accettano un parametro `timeout`.
TimeExceeded	11041	La richiesta echo ICMP non è riuscita perché il suo valore TTL (Time-To-lLive) ha raggiunto lo zero e il nodo di inoltro (router o gateway) ha eliminato di conseguenza il pacchetto.
TtlExpired	11013	La richiesta echo ICMP non è riuscita perché il suo valore TTL (Time-To-lLive) ha raggiunto lo zero e il nodo di inoltro (router o gateway) ha eliminato di conseguenza il pacchetto.
TtlReassemblyTimeExceeded	11014	La richiesta echo ICMP non è riuscita perché il pacchetto è stato diviso in frammenti per la trasmissione e non tutti i frammenti sono stati ricevuti entro il tempo massimo allocato per il reassembly. Il documento RFC 2460 specifica 60 secondi come tempo limite per ricevere tutti i frammenti di pacchetto.
Unknown	-1	La richiesta echo ICMP non è riuscita per un motivo sconosciuto.
UnrecognizedNextHeader	11043	La richiesta echo ICMP non è riuscita perché il campo Intestazione successiva non contiene un valore riconosciuto. Il campo Intestazione successiva indica il tipo di intestazione dell'estensione, se presente, o il protocollo superiore al livello dell'IP, ad esempio, TCP o UDP.

Esempio

Nell'esempio di codice seguente viene inviato un messaggio echo ICMP e viene controllato lo stato.

#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);
            }
        }
    }
}

Commenti

La Ping classe usa i valori di questa enumerazione per impostare la PingReply.Status proprietà. La Ping classe restituisce PingReply oggetti quando si chiamano i Ping.Send metodi o Ping.SendAsync per verificare se è possibile raggiungere un computer in rete.

Avviso

I valori di enumerazione DestinationProhibited e DestinationProtocolUnreachable hanno lo stesso valore numerico. Ciò è possibile perché DestinationProhibited si applica solo a IPv6 e DestinationProtocolUnreachable si applica solo a IPv4.

Si applica a