TraceFile Property  
 

Return or specify the network function trace output file.

Syntax

object.TraceFile [= value ]

Remarks

The TraceFile property is used to specify the name of the trace file that is created when network function tracing is enabled. If this property is set to an empty string, then a file named CSTRACE.LOG is created in the system's temporary directory. If no temporary directory exists, then the file is created in the current working directory.

If the file exists, the trace output is appended to the file, otherwise the file is created. Since function tracing is enabled per-process, the trace file is shared by all instances of the object being used. Since trace files can grow very quickly, even with modest applications, it is recommended that you delete the file when it is no longer needed.

The trace file has the following format:

VB6 INF: WSAAsyncSelect(46, 0xcc4, 0x7e9, 0x27) returned 0
VB6 WRN: connect(46, 192.0.0.1:1234, 16) returned -1 [10035]
VB6 ERR: accept(46, NULL, 0x0) returned -1 [10038]

The first column contains the name of the process that is being traced; in this case, it is Visual Basic 6.0. The second column identifies if the trace record is reporting information, a warning, or an error. What follows is the name of the function being called, the arguments passed to the function and the function's return value. If a warning or error is reported, the error code is included in brackets.

If parameters are passed as integer values, they are recorded in decimal. If the parameter or return value is a memory address, it is recorded as a hexadecimal value preceded with "0x". Those functions which expect Internet addresses are displayed in the following format:

aa.bb.cc.dd:nnnn

The first four numbers separated by periods represent the IP address, and the number following the colon represents the port number in host byte order. Note that in the second line of the above example, the control is attempting to connect to a system with the IP address 192.0.0.1 on port 1234.

Data Type

String

See Also

Trace Property, TraceFlags Property