Fungsi FwpmNetEventCreateEnumHandle0 (fwpmu.h)

  • Artikel

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

Sintaks

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

Parameter

[in] engineHandle

Jenis: HANDEL

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

[in, optional] enumTemplate

Jenis: FWPM_NET_EVENT_ENUM_TEMPLATE0*

Templat untuk membatasi enumerasi secara selektif.

[out] enumHandle

Jenis: HANDLE*

Handel untuk enumerasi peristiwa jaringan.

Nilai kembali

Jenis: DWORD

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.
RPC_* kode kesalahan
0x80010001—0x80010122
 Gagal berkomunikasi dengan mesin firewall jarak jauh atau lokal.

Keterangan

Jika enumTemplateadalah NULL, semua objek peristiwa jaringan dikembalikan.

Pemanggil harus memanggil FwpmNetEventDestroyEnumHandle0 untuk membebaskan handel yang dikembalikan.

Fungsi ini tidak dapat dipanggil dari dalam transaksi. Ini akan gagal dengan FWP_E_TXN_IN_PROGRESS. Lihat Manajemen Objek untuk informasi selengkapnya tentang transaksi.

Pemanggil membutuhkan akses FWPM_ACTRL_ENUM ke kontainer peristiwa. Lihat Access Control untuk informasi selengkapnya.

FwpmNetEventCreateEnumHandle0 adalah implementasi khusus dari FwpmNetEventCreateEnumHandle. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header fwpmu.h
Pustaka Fwpuclnt.lib
DLL Fwpuclnt.dll

Lihat juga

FWPM_NET_EVENT_ENUM_TEMPLATE0

FwpmNetEventDestroyEnumHandle0