SetTraceCallback-Funktion (evntrace.h)

Die SetTraceCallback-Funktion gibt eine EventCallback-Funktion an, um Ereignisse für die angegebene Ereignisablaufverfolgungsklasse zu verarbeiten.

Syntax

ULONG WMIAPI SetTraceCallback(
  [in] LPCGUID         pGuid,
  [in] PEVENT_CALLBACK EventCallback
);

Die Parameter

[in] pGuid

Zeigen Sie auf die Klassen-GUID einer Ereignisablaufverfolgungsklasse, für die Sie Ereignisse empfangen möchten. Eine Liste der GUIDs der Kernelanbieterklasse finden Sie unter NT Kernel Logger-Konstanten.

[in] EventCallback

Zeiger auf eine EventCallback-Funktion , die zum Verarbeiten von Ereignissen verwendet wird, die zur Ereignisablaufverfolgungsklasse gehören.

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 finden Sie einige häufige Fehler und deren Ursachen.

• ERROR_INVALID_PARAMETER

  Eine der folgenden Bedingungen trifft zu:

  • pGuid ist NULL.
  • EventCallback ist NULL.

Bemerkungen

Verbraucher rufen diese Funktion auf.

Sie können nur eine Rückruffunktion für eine Ereignisablaufverfolgungsklasse angeben. Wenn Sie mehrere Rückruffunktionen für die Ereignisablaufverfolgungsklasse angeben, empfängt die letzte Rückruffunktion die Ereignisse für diese Ereignisablaufverfolgungsklasse.

Rufen Sie die RemoveTraceCallback-Funktion auf, um zu verhindern, dass die Rückruffunktion Ereignisse für die Ereignisablaufverfolgungsklasse empfängt. Der Rückruf beendet automatisch den Empfang von Rückrufen, wenn Sie die Ablaufverfolgung schließen.

Mit dieser Funktion können Sie Ereignisse empfangen, die mit einer der TraceEvent-Funktionen geschrieben wurden. Sie können diese Funktion nicht verwenden, um Ereignisse von einem Anbieter zu nutzen, der eine der EventWrite-Funktionen zum Protokollieren von Ereignissen verwendet hat.

Anforderungen

Siehe auch

EventCallback

ProcessTrace

RemoveTraceCallback