Fungsi GetTraceLoggerHandle (evntrace.h)

Penyedia acara berbasis RegisterTraceGuids ("Klasik") menggunakan fungsi GetTraceLoggerHandle untuk mengambil handel sesi pelacakan peristiwa yang harus ditulis peristiwa.

Penyedia memanggil fungsi ini dari fungsi ControlCallback mereka.

Sintaks

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

Parameter

[in] Buffer

Penunjuk ke struktur WNODE_HEADER . ETW meneruskan struktur ini ke fungsi ControlCallback penyedia di parameter Buffer .

Anggota HistoricalContextdari WNODE_HEADER berisi handel sesi.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan handel sesi pelacakan peristiwa.

Jika fungsi gagal, fungsi akan mengembalikan INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Keterangan

Anda menggunakan handel saat memanggil fungsi GetTraceEnableFlags dan GetTraceEnableLevel untuk mengambil bendera aktif dan nilai tingkat yang diteruskan ke fungsi EnableTrace .

Contoh

Untuk contoh yang menggunakan GetTraceLoggerHandle, lihat Mengambil Data Peristiwa Menggunakan MOF.

Persyaratan

Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	evntrace.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

GetTraceEnableFlags

GetTraceEnableLevel