GetTraceEnableFlags-Funktion (evntrace.h)

  • Artikel

Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") verwendet die GetTraceEnableFlags-Funktion , um die vom Ablaufverfolgungscontroller angegebenen Aktivierungsflags abzurufen, um anzugeben, welche Kategorie von Ereignissen nachverfolgt werden soll.

Anbieter rufen diese Funktion über ihre ControlCallback-Funktion auf.

Syntax

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACEHANDLE TraceHandle
);

Parameter

[in] TraceHandle

Behandeln Sie eine Ereignisablaufverfolgungssitzung, die durch Aufrufen der GetTraceLoggerHandle-Funktion abgerufen wird.

Rückgabewert

Gibt den Wert zurück, den der Controller im EnableFlag-Parameter beim Aufrufen der EnableTrace-Funktion angegeben hat.

Führen Sie die folgenden Schritte aus, um zu ermitteln, ob die Funktion fehlgeschlagen ist oder der Controller die Aktivierungsflags auf 0 festgelegt hat:

  1. Rufen Sie die SetLastError-Funktion auf, um den letzten Fehler auf ERROR_SUCCESS festzulegen.
  2. Rufen Sie die GetTraceEnableFlags-Funktion auf, um die Aktivierungsflags abzurufen.
  3. Wenn der Wert für enable flags 0 ist, rufen Sie die GetLastError-Funktion auf, um den letzten bekannten Fehler abzurufen.
  4. Wenn der letzte bekannte Fehler ERROR_SUCCESS ist, legt der Controller die Aktivierungsflags auf 0 fest. Andernfalls ist die GetTraceEnableFlags-Funktion mit dem letzten bekannten Fehler fehlgeschlagen.

Hinweise

Anbieter können diesen Wert verwenden, um zu steuern, welche Ereignisse generiert werden. Beispielsweise kann ein Anbieter Ereignisse in logischen Ereigniskategorien gruppieren und diesen Wert verwenden, um deren Generierung zu aktivieren oder zu deaktivieren.

Beispiele

Ein Beispiel, das GetTraceEnableFlags verwendet, finden Sie unter Abrufen von Ereignisdaten mithilfe von MOF.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile evntrace.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

GetTraceEnableLevel

GetTraceLoggerHandle