Fungsi GetTraceEnableFlags (evntrace.h)
Penyedia peristiwa berbasis RegisterTraceGuids ("Klasik") menggunakan fungsi GetTraceEnableFlags untuk mengambil bendera aktif yang ditentukan oleh pengontrol jejak untuk menunjukkan kategori peristiwa mana yang akan dilacak.
Penyedia memanggil fungsi ini dari fungsi ControlCallback mereka.
Sintaks
ULONG WMIAPI GetTraceEnableFlags(
[in] TRACELOGGER_HANDLE TraceHandle
);
Parameter
[in] TraceHandle
Tangani ke sesi pelacakan peristiwa, diperoleh dengan memanggil fungsi GetTraceLoggerHandle .
Nilai kembali
Mengembalikan nilai pengontrol yang ditentukan dalam parameter EnableFlag 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 GetTraceEnableFlags untuk mengambil bendera aktifkan.
- Jika nilai aktifkan bendera adalah 0, panggil fungsi GetLastError untuk mengambil kesalahan terakhir yang diketahui.
- Jika kesalahan terakhir yang diketahui ERROR_SUCCESS, pengontrol mengatur bendera aktifkan ke 0; jika tidak, fungsi GetTraceEnableFlags gagal dengan kesalahan terakhir yang diketahui.
Keterangan
Penyedia dapat menggunakan nilai ini untuk mengontrol peristiwa mana yang dihasilkannya. Misalnya, penyedia dapat mengelompokkan peristiwa ke dalam kategori peristiwa logis dan menggunakan nilai ini untuk mengaktifkan atau menonaktifkan pembuatannya.
Contoh
Untuk contoh yang menggunakan GetTraceEnableFlags, lihat Mengambil Data Peristiwa Menggunakan MOF.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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 |