Fungsi FwpmNetEventEnum2 (fwpmu.h)

  • Artikel

Fungsi FwpmNetEventEnum2 mengembalikan halaman hasil berikutnya dari enumerator peristiwa jaringan.

CatatanFwpmNetEventEnum2 adalah implementasi spesifik dari FwpmNetEventEnum yang digunakan dalam Windows 8 dan yang lebih baru. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 7, FwpmNetEventEnum1 tersedia. Untuk Windows Vista, FwpmNetEventEnum0 tersedia.
 

Sintaks

DWORD FwpmNetEventEnum2(
  [in]  HANDLE          engineHandle,
  [in]  HANDLE          enumHandle,
  [in]  UINT32          numEntriesRequested,
  [out] FWPM_NET_EVENT2 ***entries,
  [out] UINT32          *numEntriesReturned
);

Parameter

[in] engineHandle

Jenis: HANDEL

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

[in] enumHandle

Jenis: HANDEL

Menangani enumerasi peristiwa jaringan yang dibuat oleh panggilan ke FwpmNetEventCreateEnumHandle0.

[in] numEntriesRequested

Jenis: UINT32

Jumlah entri enumerasi yang diminta.

[out] entries

Jenis: FWPM_NET_EVENT2***

Alamat entri enumerasi.

[out] numEntriesReturned

Jenis: UINT32*

Jumlah entri enumerasi yang dikembalikan.

Mengembalikan nilai

Jenis: DWORD

Mengembalikan kode/nilai Deskripsi
ERROR_SUCCESS
0
 Peristiwa jaringan berhasil dijumlahkan.
FWP_E_NET_EVENTS_DISABLED
0x80320013
 Pengumpulan peristiwa diagnostik jaringan dinonaktifkan. Hubungi FwpmEngineSetOption0 untuk mengaktifkannya.
FWP_E_* kode kesalahan
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 numEntriesReturned kurang dari numEntriesRequested, enumerasi habis.

Array entri yang dikembalikan (tetapi bukan entri individu itu sendiri) harus dibebaskan oleh panggilan ke FwpmFreeMemory0.

Panggilan berikutnya yang menggunakan parameter enumHandle yang sama akan mengembalikan serangkaian peristiwa berikutnya setelah yang ada di buffer entri saat ini.

FwpmNetEventEnum2 hanya mengembalikan peristiwa yang dicatat sebelum pembuatan parameter enumHandle . Lihat Pengelogan untuk informasi selengkapnya.

Persyaratan

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

Lihat juga

FWPM_NET_EVENT2

FwpmNetEventCreateEnumHandle0

Pengelogan WFP