Share via

TraceVprintf

  • Article

[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.]

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(
  DWORD dwTraceID,
  LPCTSTR lpszFormat,
  va_list arglist
);

Parameters

  • dwTraceID
    [in] Handle returned by the calling service or application's initial TraceRegister call.
  • lpszFormat
    [in] Pointer to a null-terminated string that contains format control information. For more information, see the Remarks section of the wsprintf function.
  • arglist
    [in] Specifies the prepared list of arguments that define the format of TraceVprintf output.

Return Value

If the function succeeds, TraceVprintf returns the number of characters output, excluding the terminating null-character.

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

Requirements

Server Requires Windows Server 2003 or Windows 2000 Server.
Redistributable Requires RRAS download on Windows NT Server 4.0 SP3 and later.
Header

Declared in Rtutils.h.
Library

Use Rtutils.lib.
DLL Requires Rtutils.dll.
Unicode

Implemented as TraceVprintfW (Unicode) and TraceVprintfA (ANSI).

See Also

About Tracing
Tracing Reference
TraceVprintfEx
TraceRegister
TraceDeregister
TracePrintf
TracePuts
TraceDump