TraceDeregisterEx

[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 TraceDeregisterEx function frees resources and closes files associated with tracing registration on behalf of the calling service or application. Call TraceDeregisterEx no more than once for a service or application, regardless of how many calls were made on the service or application's behalf.

DWORD TraceDeregisterEx(
  DWORD dwTraceID,
  DWORD dwFlags
);

Parameters

• dwTraceID
  [in] Handle returned by the calling service or application's initial TraceRegister call.
• dwFlags
  Specifies flags that qualify the deregistration. Currently, only the following flag is supported.

  Flag	Meaning
  TRACE_NO_SYNCH	Deregister without acquiring a write lock on the tracing server.

Return Value

If the function succeeds, the return value is 0.

If the function fails, the return value is an error code. Call GetLastError for further 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 TraceDeregisterExW (Unicode) and TraceDeregisterExA (ANSI).

See Also

About Tracing
Tracing Reference
TraceRegister
TraceDeregister
TracePrintf
TraceVprintf
TracePuts
TraceDump