Bagikan melalui


Fungsi FwpmFilterEnum0 (fwpmu.h)

Fungsi FwpmFilterEnum0 mengembalikan halaman hasil berikutnya dari enumerator filter.

Sintaks

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

Parameter

[in] engineHandle

Jenis: HANDEL

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

[in] enumHandle

Jenis: HANDEL

Menangani enumerasi filter yang dibuat oleh panggilan ke FwpmFilterCreateEnumHandle0.

[in] numEntriesRequested

Jenis: UINT32

Jumlah objek filter yang diminta.

[out] entries

Jenis: FWPM_FILTER0***

Alamat entri enumerasi.

[out] numEntriesReturned

Jenis: UINT32*

Jumlah objek filter yang dikembalikan.

Menampilkan nilai

Jenis: DWORD

Mengembalikan kode/nilai Deskripsi
ERROR_SUCCESS
0
Filter berhasil dijumlahkan.
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 numEntriesReturned kurang dari numEntriesRequested, enumerasi habis.

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

Panggilan berikutnya menggunakan handel enumerasi yang sama akan mengembalikan kumpulan item berikutnya setelah yang ada di buffer output terakhir.

FwpmFilterEnum0 bekerja pada rekam jepret filter yang diambil pada saat handel enumerasi dibuat.

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

Persyaratan

   
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_FILTER0

FwpmFilterCreateEnumHandle0