enumerasi EVT_SUBSCRIBE_FLAGS (winevt.h)

Artikel
03/13/2024

Menentukan nilai yang mungkin yang menentukan kapan harus mulai berlangganan peristiwa.

Sintaks

typedef enum _EVT_SUBSCRIBE_FLAGS {
  EvtSubscribeToFutureEvents = 1,
  EvtSubscribeStartAtOldestRecord = 2,
  EvtSubscribeStartAfterBookmark = 3,
  EvtSubscribeOriginMask = 3,
  EvtSubscribeTolerateQueryErrors = 0x1000,
  EvtSubscribeStrict = 0x10000
} EVT_SUBSCRIBE_FLAGS;

Konstanta


`EvtSubscribeToFutureEvents` Nilai: 1 Berlangganan hanya peristiwa mendatang yang cocok dengan kriteria kueri.
`EvtSubscribeStartAtOldestRecord` Nilai: 2 Berlangganan semua peristiwa yang ada dan yang akan datang yang cocok dengan kriteria kueri.
`EvtSubscribeStartAfterBookmark` Nilai: 3 Berlangganan semua peristiwa yang sudah ada dan yang akan datang yang cocok dengan kriteria kueri yang dimulai setelah peristiwa marka buku. Jika Anda menyertakan bendera EvtSubscribeStrict, fungsi EvtSubscribe gagal jika peristiwa yang diberi marka buku tidak ada. Jika Anda tidak menyertakan bendera EvtSubscribeStrict dan peristiwa yang diberi marka buku tidak ada, langganan dimulai dengan peristiwa setelah peristiwa yang paling dekat dengan peristiwa yang diberi marka buku.
`EvtSubscribeOriginMask` Nilai: 3 Bitmask yang dapat Anda gunakan untuk menentukan bendera mana yang diatur: EvtSubscribeToFutureEvents EvtSubscribeStartAtOldestRecord EvtSubscribeStartAfterBookmark
`EvtSubscribeTolerateQueryErrors` Nilai: 0x1000 Selesaikan langganan meskipun bagian kueri menghasilkan kesalahan (tidak terbentuk dengan baik). Layanan memvalidasi sintaks kueri JalurX untuk menentukan apakah kueri terbentuk dengan baik. Jika validasi gagal, layanan mengurai JalurX ke dalam ekspresi individual. Ini membangun XPath baru yang dimulai dengan ekspresi paling kiri. Layanan memvalidasi ekspresi dan jika valid, layanan menambahkan ekspresi berikutnya ke JalurX. Layanan mengulangi proses ini sampai menemukan ekspresi yang gagal. Kemudian menggunakan ekspresi valid yang ditemukan dimulai dengan ekspresi paling kiri sebagai kueri JalurX (yang berarti Anda mungkin tidak mendapatkan peristiwa yang Anda harapkan). Jika tidak ada bagian dari JalurX yang valid, panggilan EvtSubscribe gagal.
`EvtSubscribeStrict` Nilai: 0x10000 Memaksa panggilan EvtSubscribe gagal jika Anda menentukan EvtSubscribeStartAfterBookmark dan peristiwa yang diberi marka buku tidak ditemukan (nilai yang dikembalikan adalah ERROR_NOT_FOUND). Selain itu, atur bendera ini jika Anda ingin menerima pemberitahuan di panggilan balik Anda saat rekaman peristiwa hilang.

Keterangan

Bendera EvtSubscribeToFutureEvents, EvtSubscribeStartAtOldestRecord, dan EvtSubscribeStartAfterBookmark saling eksklusif.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	winevt.h

Lihat juga

EvtSubscribe

Bagikan melalui