RemoveTraceCallback function (evntrace.h)

Article
02/22/2024

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