TracePutsEx

[This Tracing API is available for use in the operating systems listed in the Requirements section. It may be altered or unavailable in subsequent versions. Instead use the Event Tracing API.]

The TracePutsEx function is an efficient way to retrieve information associated with a registered service or application's identifier (dwTraceID). TracePutsEx differs from TracePuts in its extended (Ex) flexibility with regard to output, achieved through the use of non-zero flags implemented with dwFlags. TracePutsEx also outputs the string literal passed as the function's second argument.

DWORD TracePutsEx(
  DWORD dwTraceID,
  DWORD dwFlags,
  LPCTSTR lpszString
);

Parameters

• dwTraceID
  [in] Handle returned by the calling service or application's initial TraceRegister call.

• dwFlags
  [in] Specifies the flags that control appearance of TracePutsEx output. Ensure dwFlags is one or more of the following:

  • TRACE_NO_STDINFO
    Suppresses output of the standard information associated with dwTraceID
  • TRACE_USE_MASK
    Determines whether file and/or console output is generated by comparing the high-order word of dwFlags against registry values \FileTracingMask and \ConsoleTracingMask.

• lpszString
  [in] Specifies the string to be output.

Return Value

If the function is successful, TracePuts returns the number of characters output, excluding the terminating null-character.

If the function fails, the return value is zero. This may indicate that tracing is disabled in the registry. See Tracing Configuration for more information.

Requirements

See Also

About Tracing
Tracing Reference
TracePuts
TraceRegisterEx
TracePrintfEx
TraceVprintfEx
TraceDumpEx