Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein RegisterTraceGuids-basierter Ereignisanbieter ("Classic") verwendet die GetTraceLoggerHandle-Funktion , um das Handle der Ereignisablaufverfolgungssitzung abzurufen, in die Ereignisse geschrieben werden sollen.
Anbieter rufen diese Funktion über ihre ControlCallback-Funktion auf.
Syntax
TRACEHANDLE WMIAPI GetTraceLoggerHandle(
[in] PVOID Buffer
);
Parameter
[in] Buffer
Zeiger auf eine WNODE_HEADER-Struktur . ETW übergibt diese Struktur an die ControlCallback-Funktion des Anbieters im Buffer-Parameter .
Der HistoricalContext-Member von WNODE_HEADER enthält das Handle der Sitzung.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird das Ereignisablaufverfolgungssitzungshandle zurückgegeben.
Wenn die Funktion fehlschlägt, wird INVALID_HANDLE_VALUE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.
Hinweise
Sie verwenden das Handle beim Aufrufen der Funktionen GetTraceEnableFlags und GetTraceEnableLevel , um die an die EnableTrace-Funktion übergebenen Enable-Flags und Levelwerte abzurufen.
Beispiele
Ein Beispiel, das GetTraceLoggerHandle 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 |