2.2.2.39 TS_TRACE

The TS_TRACE structure specifies fields used for configuring tracing operations in TS binaries if they are checked.

 typedef struct _TS_TRACE {
   WCHAR TraceFile[256];
   BOOLEAN fDebugger;
   BOOLEAN fTimestamp;
   ULONG TraceClass;
   ULONG TraceEnable;
   WCHAR TraceOption[64];
 } TS_TRACE,
  *PTS_TRACE;

TraceFile: Specifies the file name, if any, to which to write debug information.

fDebugger: Specifies whether debugger is attached.

fTimestamp: Specifies whether to append time stamp to the traces logged.

TraceClass: Classes of tracing to log. They enable tracing for the various terminal server binaries/functionalities. It MUST be a bitwise OR combination of one or more of the following values.

Value	Meaning
TC_ICASRV 0x00000001	Enable tracing for the Terminal Services Service.<133>
TC_ICAAPI 0x00000002	Enable tracing for the DLL providing the API for Terminal Services to communicate with the WinStation Driver.<134>
TC_ICADD 0x00000004	Enable tracing for the Terminal Services Device Driver.<135>
TC_WD 0x00000008	Enable tracing for the WinStation Driver.<136>
TC_CD 0x00000010	Enable tracing for the Connection Driver.<137>
TC_PD 0x00000020	Enable tracing for the Protocol Driver.<138>
TC_TD 0x00000040	Enable tracing for the Transport Driver.<139>
TC_RELIABLE 0x00000100	Not used.
TC_FRAME 0x00000200	Enable tracing for the Frame Protocol Driver.<140>
TC_COMP 0x00000400	Enable tracing for the Compression library.<141>
TC_CRYPT 0x00000800	Enable tracing for the Encryption binary.<142>
TC_TW 0x10000000	Not used.
TC_DISPLAY 0x10000000	Enable tracing for the Display Driver.<143>
TC_WFSHELL 0x20000000	Not used.
TC_WX 0x40000000	Enable tracing for the WinStation Extension.<144>
TC_LOAD 0x80000000	Enable tracing for the Load balancing binary.<145>
TC_ALL 0xffffffff	Everything.

TraceEnable: Type of tracing calls log. It MUST be a bitwise OR combination of one or more of the following values.

Value	Meaning
TT_API1 0x00000001	API level 1.
TT_API2 0x00000002	API level 2.
TT_API3 0x00000004	API level 3.
TT_API4 0x00000008	API level 4.
TT_OUT1 0x00000010	Output level 1.
TT_OUT2 0x00000020	Output level 2.
TT_OUT3 0x00000040	Output level 3.
TT_OUT4 0x00000080	Output level 4.
TT_IN1 0x00000100	Input level 1.
TT_IN2 0x00000200	Input level 2.
TT_IN3 0x00000400	Input level 3.
TT_IN4 0x00000800	Input level 4.
TT_ORAW 0x00001000	Raw output data.
TT_IRAW 0x00002000	Raw input data.
TT_OCOOK 0x00004000	Cooked output data.
TT_ICOOK 0x00008000	Cooked input data.
TT_SEM 0x00010000	Semaphores.
TT_NONE 0x10000000	Only view errors.
TT_ERROR 0xffffffff	Error condition.

TraceOption: Trace option string. This SHOULD be in the format "<filename>(start-end)", where <filename> is the name of the file that requires trace to be collected and (start-end) is the starting and ending line numbers during which trace is to be collected. This is an optional parameter and can be an empty string meaning collect trace for all files belonging to TraceClass and all lines in those files.