Baca dalam bahasa Inggris

Bagikan melalui

Fungsi FwpmNetEventCreateEnumHandle0 (fwpmk.h)

  • Artikel

Fungsi FwpmNetEventCreateEnumHandle0 membuat handel yang digunakan untuk menghitung serangkaian peristiwa jaringan.

Sintaksis

NTSTATUS FwpmNetEventCreateEnumHandle0(
  [in]           HANDLE                              engineHandle,
  [in, optional] const FWPM_NET_EVENT_ENUM_TEMPLATE0 *enumTemplate,
  [out]          HANDLE                              *enumHandle
);

Parameter

[in] engineHandle

Menangani sesi terbuka ke mesin filter. Panggil FwpmEngineOpen0 untuk membuka sesi ke mesin filter.

[in, optional] enumTemplate

Templat untuk membatasi enumerasi secara selektif.

[out] enumHandle

Handel untuk enumerasi peristiwa jaringan.

Mengembalikan nilai

Mengembalikan kode/nilai Deskripsi
ERROR_SUCCESS
0		 Enumerator berhasil dibuat.
kode kesalahan FWP_E_*
0x80320001—0x80320039		 Kesalahan spesifik Windows Filtering Platform (WFP). Lihat Kode Kesalahan WFP untuk detailnya.
kode kesalahan RPC_*
0x80010001—0x80010122		 Gagal berkomunikasi dengan mesin firewall jarak jauh atau lokal.
Kode NTSTATUS lainnya Terjadi kesalahan.

Komentar

Jika enumTemplate NULL, semua objek peristiwa jaringan dikembalikan.

Pemanggil harus memanggil FwpmNetEventDestroyEnumHandle0 untuk membebaskan handel yang dikembalikan.

Fungsi ini tidak dapat dipanggil dari dalam transaksi, gagal dengan FWP_E_TXN_IN_PROGRESS. Lihat Object Management untuk informasi selengkapnya tentang transaksi.

Pemanggil memerlukan akses FWPM_ACTRL_ENUM ke kontainer peristiwa. Lihat Kontrol Akses untuk informasi selengkapnya.

FwpmNetEventCreateEnumHandle0 adalah implementasi spesifik dari FwpmNetEventCreateEnumHandle. Lihat Nama Version-Independent WFP dan Penargetan Versi Spesifik Windows untuk informasi selengkapnya.

Persyaratan

Syarat Nilai
klien minimum yang didukung Tersedia dimulai dengan Windows Vista.
Platform Target Universal
Header fwpmk.h
Pustaka fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Lihat juga