GetTraceEnableFlags-Funktion (evntrace.h)
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] TRACELOGGER_HANDLE 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:
- Rufen Sie die SetLastError-Funktion auf, um den letzten Fehler auf ERROR_SUCCESS festzulegen.
- Rufen Sie die GetTraceEnableFlags-Funktion auf, um die Aktivierungsflags abzurufen.
- Wenn der Wert für enable flags 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 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 |