Bagikan melalui

Fungsi GetTraceEnableFlags (evntrace.h)

  • Artikel

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:

  1. Panggil fungsi SetLastError untuk mengatur kesalahan terakhir ke ERROR_SUCCESS.
  2. Panggil fungsi GetTraceEnableFlags untuk mengambil bendera aktifkan.
  3. Jika nilai aktifkan bendera adalah 0, panggil fungsi GetLastError untuk mengambil kesalahan terakhir yang diketahui.
  4. 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

Lihat juga

GetTraceEnableLevel

GetTraceLoggerHandle