TraceVprintf

[This is preliminary documentation and subject to change.]

Functionality of TraceVprintf is very similar to that of TracePrintf, except that it takes a prepared variable argument list as its third variable. See TracePrintf for more information.

DWORD TraceVprintf(
  IN DWORD dwTraceID,     //handle from initial TraceRegister call
  IN LPCTSTR lpszFormat,  //printf-style formatting information
  IN va_list arglist      //prepared list of variable arguments
);
 

Parameters

dwTraceID

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

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 TraceVprintf 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

TraceVprintfEx, TraceRegister, TraceDeregister, TracePrintf, TracePuts, TraceDump, GetLastError