Share via


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