TraceTo Method
Trace the route to a host.
Syntax
ANSI (Cross Platform) int TraceTo(const char* lpszHost); Unicode (Windows) INT TraceTo(LPCWSTR lpszHost);
- (void)traceTo:(NSString*)host;
#define MID_TRACEROUTE_TRACETO 6 IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_TraceRoute_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);
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 (C++)
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.)