RemoveTraceCallback-Funktion (evntrace.h)

  • Artikel

Wichtig

Verwenden Sie diese Funktion nicht. In nachfolgenden Versionen ist sie möglicherweise nicht verfügbar.

Die RemoveTraceCallback-Funktion verhindert, dass eine EventCallback-Funktion Ereignisse für eine Ereignisablaufverfolgungsklasse empfängt.

Syntax

ULONG WMIAPI RemoveTraceCallback(
  [in] LPCGUID pGuid
);

Parameter

[in] pGuid

Zeiger auf die Klassen-GUID der Ereignisablaufverfolgungsklasse, für die der Rückruf Ereignisse empfängt. Verwenden Sie dieselbe Klassen-GUID, die Sie an SetTraceCallback übergeben haben, um mit dem Empfangen der Ereignisse zu beginnen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der Systemfehlercodes. Im Folgenden sind einige häufige Fehler und deren Ursachen aufgeführt.

  • ERROR_INVALID_PARAMETER

    Der pGuid-Parameter ist NULL.

  • ERROR_WMI_GUID_NOT_FOUND

    Der Ereignisablaufverfolgungsklasse ist keine EventCallback-Funktion zugeordnet.

Hinweise

Consumer rufen diese Funktion auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile evntrace.h
Bibliothek Sechost.lib auf Windows 8.1 und Windows Server 2012 R2; Advapi32.lib unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP
DLL Sechost.dll unter Windows 8.1 und Windows Server 2012 R2; Advapi32.dll unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP

Weitere Informationen

EventCallback

ProcessTrace

SetTraceCallback