Bagikan melalui

Fungsi GetTraceEnableLevel (evntrace.h)

  • Artikel

Penyedia peristiwa berbasis RegisterTraceGuids ("Klasik") menggunakan fungsi GetTraceEnableLevel untuk mengambil tingkat pengaktifan yang ditentukan oleh pengontrol pelacakan untuk menunjukkan tingkat peristiwa mana yang akan dilacak.

Penyedia memanggil fungsi ini dari fungsi ControlCallback mereka.

Sintaks

UCHAR WMIAPI GetTraceEnableLevel(
  [in] TRACEHANDLE TraceHandle
);

Parameter

[in] TraceHandle

Tangani ke sesi pelacakan peristiwa, yang diperoleh dengan memanggil fungsi GetTraceLoggerHandle .

Menampilkan nilai

Mengembalikan nilai pengontrol yang ditentukan dalam parameter EnableLevel saat memanggil fungsi EnableTrace .

Untuk menentukan apakah fungsi gagal atau pengontrol mengatur bendera aktifkan ke 0, ikuti langkah-langkah berikut:

  1. Panggil fungsi SetLastError untuk mengatur kesalahan terakhir ke ERROR_SUCCESS.
  2. Panggil fungsi GetTraceEnableLevel untuk mengambil tingkat pengaktifan.
  3. Jika nilai tingkat aktifkan adalah 0, panggil fungsi GetLastError untuk mengambil kesalahan terakhir yang diketahui.
  4. Jika kesalahan terakhir yang diketahui adalah ERROR_SUCCESS, pengontrol mengatur tingkat aktifkan ke 0; jika tidak, fungsi GetTraceEnableLevel gagal dengan kesalahan terakhir yang diketahui.

Keterangan

Penyedia menggunakan nilai ini untuk mengontrol tingkat keparahan peristiwa yang dihasilkannya. Misalnya, penyedia dapat menggunakan nilai ini untuk menentukan apakah itu harus menghasilkan peristiwa informasi, peringatan, atau kesalahan.

Contoh

Untuk contoh yang menggunakan GetTraceEnableLevel, 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

GetTraceLoggerHandle