| |
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
|
|