RemoveTraceCallback function (evntrace.h)

Important

Do not use this function. It may be unavailable in subsequent versions.

The RemoveTraceCallback function stops an EventCallback function from receiving events for an event trace class.

Syntax

ULONG WMIAPI RemoveTraceCallback(
  [in] LPCGUID pGuid
);

Parameters

[in] pGuid

Pointer to the class GUID of the event trace class for which the callback receives events. Use the same class GUID that you passed to the SetTraceCallback to begin receiving the events.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is one of the system error codes. The following are some common errors and their causes.

  • ERROR_INVALID_PARAMETER

    The pGuid parameter is NULL.

  • ERROR_WMI_GUID_NOT_FOUND

    There is no EventCallback function associated with the event trace class.

Remarks

Consumers call this function.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header evntrace.h
Library Sechost.lib on Windows 8.1 and Windows Server 2012 R2; Advapi32.lib on Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista and Windows XP
DLL Sechost.dll on Windows 8.1 and Windows Server 2012 R2; Advapi32.dll on Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista and Windows XP

See also

EventCallback

ProcessTrace

SetTraceCallback