VoltoTRC
TraceRoute and Ping Component
Introduction
User Guide
Technical Reference
Download
Buy a License
Other Volto Components
|
|
|
|
| Product Name |
VoltoTRC TraceRoute and Ping Component |
| Function |
Reports on roundtrip times and network routing to remote hosts |
| File Name |
VoltoTRC.DLL |
| File Size |
60.0KB (61,440 bytes) |
| Current Version |
V1.0 |
| Release Date |
19-NOV-2000 |
| Component Type |
ActiveX DLL |
| ProgID |
VoltoTRC.TRC |
| CLSID |
C24292D2-BBE3-11D4-A646-00105A4907E2 |
| DLL Base Address |
&H41070000 |
| Prerequisites |
Visual Basic 6.0 runtime |
| License Price: |
$14.95 |
|
|
|
ReplyAddress
Read only. Returns a string value containing the IP address of the host that
responded to a ping.
Syntax
object.ReplyAddress
ReplyHostName
Read only. Attempts to resolve the IP address of the host that responded to a ping
and if successful, returns a string value containing the host name. If name
resolution is not possible, an empty string is returned.
Syntax
object.ReplyHostName
ReplyTTL
Read only. Returns a long value containing the TTL (time to live) value of the
packet received in response to a ping.
Syntax
object.ReplyAddress
RoundTripTime
Read only. Returns a long value containing the roundtrip time (in milliseconds)
for a ping.
Syntax
object.ReplyAddress
Timeout
Sets the timeout for each hop in a ping. By
default, this value is set to 500ms.
Syntax
object.Timeout [= timeout]
The Timeout property has the following parts:
| Part | Description |
| object |
An instance of the VoltoTRC control. |
| timeout |
Long value specifying the timeout in milliseconds. |
TTL
Sets the TTL (time to live or maximum number of hops) value for packets set during a
ping. By default, this value is set to 128. By setting this value before
calling the ping method, you can discover routers at each hop along the
route to a target host. For example, set TTL to 1 to discover the nearest
router. By repeatedly incrementing the TTL value, you can implement
traceroute functionality.
Syntax
object.TTL [= maxhops]
The TTL property has the following parts:
| Part | Description |
| object |
An instance of the VoltoTRC control. |
| maxhops |
Long value specifying the time to live for the ping packets. |
|
|
|
|
Ping
Pings a remote host using the TTL and timeout values specified by the
TTL and Timeout properties. To implement TraceRoute functionality, set
the TTL property initially to 1 and then increment it after each ping
to allow the ping to discover each router on the route to the target host.
Syntax
object.Ping (Host)
The Ping method has the following parts:
| Part |
Description |
| object |
An instance of the VoltoTRC control. |
| Host |
Required. String value specifying the target host to ping. This
may be an IP address or host name. If a host name is specified, VoltoTRC will
first attempt to resolve the name to an IP address.
|
The roundtrip ping time can be read from the
RoundTripTime property following a successful ping.
Errors
The following errors may be raised by the ping method. Errors greater than
11000 and less than 12000 are ICMP errors:
| Error |
Description |
| 12001 |
Could not initialise Winsock |
| 12002 |
Unable to resolve host name |
| 12003 |
No host specified |
| 12004 |
Unknown error |
| 11001 |
IP buffer too small |
| 11002 |
IP destination net unreachable |
| 11003 |
IP destination host unreachable |
| 11004 |
IP destination prot unreachable |
| 11005 |
IP destination port unreachable |
| 11006 |
IP no resources |
| 11007 |
IP bad option |
| 11008 |
IP hw error |
| 11009 |
IP packet too big |
| 11010 |
IP request timed out |
| 11011 |
IP bad request |
| 11012 |
IP bad route |
| 11013 |
IP TTL expired in transit |
| 11014 |
IP TTL expired reassem |
| 11015 |
IP param problem |
| 11016 |
IP source quench |
| 11017 |
IP option too big |
| 11018 |
IP bad destination |
| 11019 |
IP address deleted |
| 11020 |
IP option too big |
| 11021 |
IP spec mtu change |
| 11022 |
IP unload |
| 11023 |
IP addr added |
| 11024 |
IP general failure |
| 11025 |
IP pending |
| Note: |
Error number 11013 (IP TTL expired transit) will be raised
following a succesful ping with a TTL smaller than the number of hops to the
target host. When implementing traceroute functionality, this error is
therefore to be expected (and should not be processed as an error) after each ping
for each hop along the route except the last hop when no error will be raised.
|
ProductLicense
Unlocks full component functionality when a valid Serial Number and License Key pair is
given. The Serial Number and License Key, together with a license file, are provided when
purchasing a license for this component.
Syntax
object.ProductLicense (SerialNo, LicenseKey)
The ProductLicense method has the following parts:
| Part |
Description |
| object |
An instance of the VoltoB64 control. |
| SerialNo |
String value specifying a valid Serial Number. |
| LicenseKey |
String value specifying a valid License Key. |
Return Value
Returns true if a valid Serial Number and License Key was specified. Otherwise,
returns False.
Remarks
Call this method once only, immediately after creating the object, in order to
unlock full component functionality. If you do not make a successful call to this
method, then only restricted, evaluation mode functionality will be available.
Note that the license file provided to licensed users must be present in the
same directory as that in which the component has been installed. This file must also
be distributed with compiled applications and copied to the appropriate directory by
the application's setup utility.
|
|
© Copyright 2005 VOLTO.COM
|
|