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