HopResult Class

Encapsulates a single hop of a trace operation.

For a list of all members of this type, see HopResult members.

Object Model

Inheritance Hierarchy

System.Object
Dart.PowerTCP.SslSockets.HopResult

Syntax

[Visual Basic]
Public Class HopResult

[C#]
public class HopResult

[C++]
public __gc class HopResult

[C++/CLI]
public ref class HopResult

Remarks

After beginning a trace route operation using Send or BeginSend, the Hop event is raised when data is returned from each new hop. Passed into this event is a HopEventArgs object. The Result property of this object is the HopResult representing this hop. For example, Echoes returns an array of three EchoResults representing the three ICMP echoes which comprise this hop.

Example

The following example demonstrates a basic trace route operation.

[Visual Basic]

Private Sub TraceTest()

   ' Set all hops and echoes to be synchronous

   Trace1.HopType = HopType.SynchHops



   ' Do not exceed 25 hops

   Trace1.MaxHops = 25



   ' Trace the route. Trace.Hop event will be raised when new hop data is available

   Dim tr As TraceResult = Trace1.Send("www.dart.com")



   ' Trace route complete. Display some data.

   Debug.WriteLine("Average time for final hop: " & tr.AverageTime)

   Debug.WriteLine("Number of hops: " & tr.Hops.Length)

   Debug.WriteLine("Remote Address: " & tr.RemoteAddress)

End Sub



Private Sub Trace1_Hop(ByVal sender As Object, ByVal e As HopEventArgs) Handles Trace1.Hop

   ' Display information about the hop

   Debug.WriteLine("Time-to-live for the hop: " & e.Result.TTL)

   Debug.WriteLine("Remote address: " & e.Result.RemoteAddress)



   ' Now display info about each of the three echoes

   Debug.WriteLine("Response times for this hop")

   Dim er As EchoResult

   For Each er In e.Result.Echoes

      Debug.WriteLine(er.ResponseTime)

   Next



   Debug.WriteLine("Average time for this hop: " & e.Result.AverageTime)

End Sub

[C#]



private void TraceTest()

{

  // Set all hops and echoes to be synchronous

  trace1.HopType = HopType.SynchHops;



  // Do not exceed 25 hops

  trace1.MaxHops = 25;



  // Trace the route. Trace.Hop event will be raised when new hop data is available

  TraceResult tr = trace1.Send("www.dart.com");



  // Trace route complete. Display some data.

  Debug.WriteLine("Average time for final hop: " +
tr.AverageTime);

  Debug.WriteLine("Number of hops: " + tr.Hops.Length);

  Debug.WriteLine("Remote Address: " + tr.RemoteAddress);

}


private void trace1_Hop(object sender, HopEventArgs e)

{

  // Display information about the hop

  Debug.WriteLine("Time-to-live for the hop: " +
e.Result.TTL);

  Debug.WriteLine("Remote address: " + e.Result.RemoteAddress);



  // Now display info about each of the three echoes

  Debug.WriteLine("Response times for this hop");

  foreach(EchoResult er in e.Result.Echoes)

     Debug.WriteLine(er.ResponseTime);



  Debug.WriteLine("Average time for this hop: " + e.Result.AverageTime);

}

Requirements

Namespace: Dart.PowerTCP.SslSockets

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: Dart.PowerTCP.SslSockets (in Dart.PowerTCP.SslSockets.dll)

See Also

Requirements

Language

HopResult Class

Object Model

Inheritance Hierarchy

Syntax

Remarks

Example

Requirements

See Also