OnTrace Event  
 

The OnTrace event is generated for each intermediate host when tracing the route from the local system to a remote host.

Syntax

Sub object_OnTrace( [Index As Integer,] ByVal Distance As Variant, ByVal RemoteHost As Variant, ByVal TripAverage As Variant ByVal TripMaximum As Variant ByVal TripMinimum As Variant )

Remarks

The OnTrace event is generated when the TraceRoute method is called. This event will fire for each intermediate host in the route from the local system and the remote host. The following arguments are passed to the event handler:

Distance
An integer which specifies distance from the local system to the specified host. This value represents the number of times that the packet was forwarded through a router, also known as the number of "hops" to the remote host. With a trace route, this value will start at one and increment by one for each intermediate host until the destination is reached or the operation times out.
RemoteHost
A string which specifies the host name or IP address for the host along the route. If the AutoResolve property is True, then the control will attempt to determine the host name of the system. If the host name can not be determined, or the property is False, then this argument will specify the IP address. Note that performing the reverse DNS lookup to resolve the host name can be time consuming.
TripAverage
An integer which specifies the average number of milliseconds that it took for a series of ICMP echo packets to be returned from the host.
TripMaximum
An integer which specifies the maximum number of milliseconds that it took for a series of ICMP echo packets to be returned from the host.
TripMinimum
An integer which specifies the minimum number of milliseconds that it took for a series of ICMP echo packets to be returned from the host.

See Also

AutoResolve Property, TraceRoute Method