GetTraceEnableLevel-Funktion (evntrace.h)
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.
UCHAR WMIAPI GetTraceEnableLevel(
[in] TRACEHANDLE TraceHandle
);
[in] TraceHandle
Behandeln Sie eine Ereignisablaufverfolgungssitzung, die durch Aufrufen der GetTraceLoggerHandle-Funktion abgerufen wird.
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:
- Rufen Sie die SetLastError-Funktion auf, um den letzten Fehler auf ERROR_SUCCESS festzulegen.
- Rufen Sie die GetTraceEnableLevel-Funktion auf, um die Aktivierungsebene abzurufen.
- Wenn der Wert der Aktivierungsebene 0 ist, rufen Sie die GetLastError-Funktion auf, um den letzten bekannten Fehler abzurufen.
- 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.
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.
Ein Beispiel, das GetTraceEnableLevel verwendet, finden Sie unter Abrufen von Ereignisdaten mithilfe von MOF.
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 |