GetTraceEnableLevel-Funktion (evntrace.h)

  • Artikel

Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") verwendet die GetTraceEnableLevel-Funktion , um die vom Ablaufverfolgungscontroller angegebene Aktivierungsebene abzurufen, um anzugeben, welche Ebene von Ereignissen nachverfolgt werden soll.

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

Syntax

UCHAR WMIAPI GetTraceEnableLevel(
  [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 EnableLevel-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 GetTraceEnableLevel-Funktion auf, um die Aktivierungsebene abzurufen.
  3. Wenn der Wert der Aktivierungsebene 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 Aktivierungsstufe auf 0 fest. Andernfalls ist die GetTraceEnableLevel-Funktion mit dem letzten bekannten Fehler fehlgeschlagen.

Hinweise

Anbieter verwenden diesen Wert, um den Schweregrad der generierten Ereignisse zu steuern. Anbieter können beispielsweise diesen Wert verwenden, um zu bestimmen, ob Informations-, Warnungs- oder Fehlerereignisse generiert werden sollen.

Beispiele

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

Anforderungen

   
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

GetTraceEnableFlags

GetTraceLoggerHandle