IcmpV4Statistics.TimeExceededMessagesReceived Property

Reference

Definition

Namespace:: System.Net.NetworkInformation

Assembly:: System.Net.NetworkInformation.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the number of Internet Control Message Protocol version 4 (ICMPv4) Time Exceeded messages that were received.

public:
 abstract property long TimeExceededMessagesReceived { long get(); };

public abstract long TimeExceededMessagesReceived { get; }

member this.TimeExceededMessagesReceived : int64

Public MustOverride ReadOnly Property TimeExceededMessagesReceived As Long

Property Value

Int64

An Int64 value that specifies the total number of ICMP Time Exceeded messages that were received.

Examples

The following example displays the value of this property.

void ShowTimeExceededData()
{
   IPGlobalProperties ^ properties = IPGlobalProperties::GetIPGlobalProperties();
   IcmpV4Statistics ^ statistics = properties->GetIcmpV4Statistics();
   Console::WriteLine( "  TimeExceeded ........................ Sent: {0,-10}   Received: {1,-10}", 
      statistics->TimeExceededMessagesSent, 
      statistics->TimeExceededMessagesReceived );
}

public static void ShowTimeExceededData()
{
    IPGlobalProperties properties = IPGlobalProperties.GetIPGlobalProperties();
    IcmpV4Statistics statistics = properties.GetIcmpV4Statistics();
    Console.WriteLine("  TimeExceeded ........................ Sent: {0,-10}   Received: {1,-10}",
        statistics.TimeExceededMessagesSent, statistics.TimeExceededMessagesReceived);
}

Public Shared Sub ShowTimeExceededData() 
    Dim properties As IPGlobalProperties = IPGlobalProperties.GetIPGlobalProperties()
    Dim statistics As IcmpV4Statistics = properties.GetIcmpV4Statistics()
    Console.WriteLine("  TimeExceeded ........................ Sent: {0,-10}   Received: {1,-10}", statistics.TimeExceededMessagesSent, statistics.TimeExceededMessagesReceived)

End Sub

Remarks

A packet's Hop Limit determines how many times it can be forwarded before it is discarded. Each time a packet is forwarded, its Hop Limit value is decremented by one. When the Hop Limit reaches zero or when a router receives a packet with its Hop Limit set to zero, the packet is discarded and the source of the packet receives a Time Exceeded message indicating that the initial Hop Limit was too small or that the packet was caught in a routing loop.

Applies to

Jaa