Fungsi TraceLoggingRegisterEx (traceloggingprovider.h)

Artikel
08/26/2023

Mendaftarkan penyedia TraceLogging sehingga dapat digunakan untuk mencatat peristiwa, menentukan panggilan balik pengaktifan ETW. Pendaftaran berlaku sampai penyedia tidak terdaftar atau proses keluar.

Sintaks

TLG_STATUS TraceLoggingRegisterEx(
  [in, out]      TraceLoggingHProvider hProvider,
  [in, optional] TLG_PENABLECALLBACK   pEnableCallback,
  [in, optional] PVOID                 pCallbackContext
);

Parameter

[in, out] hProvider

Handel penyedia TraceLogging untuk mendaftar. Handel belum boleh didaftarkan.

[in, optional] pEnableCallback

ETW Aktifkan Panggilan Balik yang akan dipanggil saat sesi pelacakan mengaktifkan atau menonaktifkan penyedia Anda.

[in, optional] pCallbackContext

Penunjuk konteks yang ditentukan penyedia opsional untuk diteruskan ke panggilan balik.

Menampilkan nilai

Jika Anda memanggil fungsi ini dari kode mode pengguna, fungsi mengembalikan HRESULT. SUCCEEDED() Gunakan makro untuk menentukan apakah fungsi berhasil.

Jika Anda memanggil fungsi ini dari kode mode kernel, fungsi mengembalikan NTSTATUS. NT_SUCCESS() Gunakan makro untuk menentukan apakah fungsi berhasil.

Catatan

Kode kesalahan yang dikembalikan oleh TraceLoggingRegisterEx terutama ditujukan untuk digunakan dalam skenario penelusuran kesalahan dan diagnostik. Sebagian besar kode produksi harus terus berjalan meskipun penyedia ETW gagal mendaftar, jadi build rilis biasanya harus mengabaikan kode kesalahan yang dikembalikan oleh TraceLoggingRegisterEx.

Keterangan

Lihat TraceLoggingRegister untuk detail tentang penyedia pendaftaran. Lihat ETW Aktifkan Panggilan Balik untuk detail tentang perilaku panggilan balik.

TraceLoggingRegisterEx melakukan hal berikut:

Memanggil EventRegister untuk membuka koneksi ke ETW.
Jika EventRegister berhasil, panggil TraceLoggingSetInformation dengan InformationClassEventProviderSetTraits untuk mengonfigurasi penyedia untuk dukungan TraceLogging.

Panggilan ke TraceLoggingRegister sama dengan panggilan ke TraceLoggingRegisterEx dengan NULL untuk parameter panggilan balik dan konteks . Gunakan TraceLoggingRegisterEx jika Anda perlu menerima Panggilan Balik Aktifkan ETW saat sesi mengaktifkan atau menonaktifkan penyedia Anda.

Persyaratan


Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	traceloggingprovider.h
Pustaka	Advapi32.lib
DLL	T/A