GetTraceLoggerHandle-Funktion (evntrace.h)
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 |