Fungsi FwpmSessionEnum0 (fwpmu.h)

Artikel
02/26/2024

Fungsi FwpmSessionEnum0 mengembalikan halaman hasil berikutnya dari enumerator sesi.

Sintaks

DWORD FwpmSessionEnum0(
  [in]  HANDLE        engineHandle,
  [in]  HANDLE        enumHandle,
  [in]  UINT32        numEntriesRequested,
  [out] FWPM_SESSION0 ***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

Tangani untuk enumerasi sesi yang dibuat oleh panggilan ke FwpmSessionCreateEnumHandle0.

[in] numEntriesRequested

Jenis: UINT32

Jumlah entri sesi yang diminta.

[out] entries

Jenis: FWPM_SESSION0***

Alamat entri enumerasi.

[out] numEntriesReturned

Jenis: UINT32*

Jumlah objek sesi yang dikembalikan.

Nilai kembali

Jenis: DWORD

Mengembalikan kode/nilai	Deskripsi
ERROR_SUCCESS 0	Sesi berhasil dijumlahkan.
*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 menggunakan handel enumerasi yang sama akan mengembalikan kumpulan item berikutnya setelah yang ada di buffer output terakhir.

FwpmSessionEnum0 bekerja pada rekam jepret sesi yang diambil pada saat handel enumerasi dibuat.

FwpmSessionEnum0 adalah implementasi khusus dari FwpmSessionEnum. 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_SESSION0

FwpmSessionCreateEnumHandle0

Bagikan melalui