Fungsi GetTraceEnableLevel (evntrace.h)
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:
- Panggil fungsi SetLastError untuk mengatur kesalahan terakhir ke ERROR_SUCCESS.
- Panggil fungsi GetTraceEnableLevel untuk mengambil tingkat pengaktifan.
- Jika nilai tingkat aktifkan adalah 0, panggil fungsi GetLastError untuk mengambil kesalahan terakhir yang diketahui.
- 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 |