TraceTo Method

Trace the route to a host.

Syntax

int TraceTo(const QString& qsHost);

Remarks

Traces are initiated by calling TraceTo, with the Host argument set to the name or address of the destination host to trace to. Host must contain a valid Internet domain name or address, or the class fails with an error. To interrupt a trace in progress, set RemoteHost to empty string. Calling this method is equivalent to setting the RemoteHost property to Host.

Example (Perform a TraceRoute)


TraceRouteControl.TraceTo("myHost")
is equivalent to
TraceRouteControl.RemoteHost = "myHost"

Error Handling

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 Qt Edition - Version 20.0 [Build 8307]