IcmpV4Statistics::TimeExceededMessagesSent Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Net.NetworkInformation
Assembly:  System (in System.dll)

public:
property long long TimeExceededMessagesSent {
	virtual long long get() abstract;
}

Property Value

Type: System::Int64

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

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.

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

.NET Framework
Available since 2.0
Return to top
Show: