TraceVprintfEx

[This is preliminary documentation and subject to change.]

Functionality of TraceVprintfEx is very similar to that of TracePrintfEx, except that it takes a prepared variable argument list as its third variable. TraceVprintfEx differentiates itself from TraceVprintf in its ability to customize output through the use of non-zero flags. See TracePrintfEx for more information.

DWORD TraceVprintfEx(
  IN DWORD dwTraceID,
  IN DWORD dwFlags OPTIONAL,
  IN LPCTSTR lpszFormat,
  IN va_list arglist
);
 

Parameters

dwTraceID

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

dwFlags

Flags that control appearance of TraceVprintfEx 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 will be generated by comparing the high-order word of dwFlags against registry values FileTracingMask and ConsoleTracingMask.

lpszFormat

Pointer to a null-terminated string containing printf-style format control information.

arglist

A prepared list of printf()-style arguments that define the format of TraceVprintf output.

Return Values

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

Failure returns a zero. The error code can be retrieved by calling GetLastError.

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

TraceVprintf, TraceRegisterEx, TraceDeregisterEx, TracePrintfEx, TracePutsEx, TraceDumpEx, GetLastError