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.
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:
- 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.
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 |