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

Weitere Informationen

GetTraceEnableFlags

GetTraceEnableLevel