TraceFlags Property  
 

Gets and sets the socket function tracing flags.

Syntax

object.TraceFlags [= flags ]

Remarks

The TraceFlags property is used to specify the type of information written to the trace file when socket function tracing is enabled. The following values may be used:

Value Constant Description
0 stTraceInfo All function calls are written to the trace file. This is the default value.
1 stTraceError Only those function calls which fail are recorded in the trace file.
2 stTraceWarning Only those function calls which fail, or return values which indicate a warning, are recorded in the trace file.
4 stTraceHexDump All functions calls are written to the trace file, plus all the data that is sent or received is displayed, in both ASCII and hexadecimal format.

Since socket function tracing is enabled per-process, the trace flags are shared by all instances of the controls being used. If multiple controls have tracing enabled, the TraceFlags property should be set to the same value for each control. Changing the trace flags for any one instance of the control will affect the logging performed for all controls used by the application.

Warnings are generated when a non-fatal error is returned by a Windows Sockets function. For example, if data is being written through the control and the error WSAEWOULDBLOCK is returned, a warning is generated since the application simply needs to attempt to write the data at a later time.

Data Type

String

See Also

Trace Property, TraceFile Property