TracePuts

[This is preliminary documentation and subject to change.]

The TracePuts function is an efficient way to retrieve information associated with a registered service or application's identifier (dwTraceID). TracePuts also outputs the string literal passed as the function's second argument.

DWORD TracePuts(
  IN DWORD dwTraceID,
  IN LPCTSTR lpszString
);
 

Parameters

dwTraceID

The handle returned by the calling service or application's initial TraceRegister call.

lpszString

The string to be output.

Return Value

Successful execution of TracePuts returns the number of characters output, excluding the terminating null-character.

Failure of the TracePuts call returns zero. Call GetLastError to get the error code.

TracePuts outputs the name associated with dwTraceID, the internal thread identifier used to identify the caller, the current time, and the literal string specified by lpszString. Since TracePuts performs no formatting on its arguments, it is more efficient than TracePrintf or TraceVprintf. To suppress the prefixes and prevent output from starting on a new line, see TracePutsEx.

QuickInfo

  Windows NT: Use version 5.0 and later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in rtutils.h.
  Import Library: Link with rtutils.lib.

See Also

TracePutsEx, TraceRegister, TraceDeregister, TracePrintf, TraceVprintf, TraceDump, GetLastError