[This is preliminary documentation and subject to change.]
The TracePrintf function outputs tracing information, including the following: calling service or application's name, the current time, and tracing information in the format specified by the optional argument or arguments included in lpszFormat. See the note below for an example of TracePrintf results.
DWORD TracePrintf(
IN DWORD dwTraceID, // handle from initial TraceRegister call
IN LPCTSTR lpszFormat, // printf()-style formatting information
IN ...OPTIONAL // one or more optional arguments
);
Successful execution of TracePrintf returns the number of characters output, excluding the terminating null-character.
Failure returns zero. The error code can be retrieved by calling GetLastError.
The following is an example for the output from TracePrintf. In the following example, the service or application calling TracePrintf is IPRIP, and its associated Thread identifier for use with the RRAS tracing functionality is129:
[IPRIP:129] 21:01:20: new entry: dest=0.0.0.0, nexthop=157.55.80.1, metric=1, protocol=2
[IPRIP:129] 21:01:20: received RIP v1 response from 157.55.84.244 on address 157.55.94.40
To suppress the prefixes, use TracePrintfEx.
Windows NT: Use version 5.0 and later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in rtutils.h.
Import Library: Link with rtutils.lib.
TracePrintfEx, TraceRegister, TraceDeregister, TraceVprintf, TracePuts, TraceDump, GetLastError