Baca dalam bahasa Inggris

Bagikan melalui

Fungsi IPsecSaEnum1 (fwpmk.h)

  • Artikel

Fungsi IPsecSaEnum1 mengembalikan halaman hasil berikutnya dari enumerator asosiasi keamanan IPsec (SA).

Sintaksis

NTSTATUS IPsecSaEnum1(
  [in]  HANDLE            engineHandle,
  [in]  HANDLE            enumHandle,
  [in]  UINT32            numEntriesRequested,
  [out] IPSEC_SA_DETAILS1 ***entries,
  [out] UINT32            *numEntriesReturned
);

Parameter

[in] engineHandle

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

[in] enumHandle

Menangani enumerasi IPsec SA. Panggil IPsecSaCreateEnumHandle0 untuk mendapatkan handel enumerasi.

[in] numEntriesRequested

Jumlah entri enumerasi yang diminta.

[out] entries

Alamat entri enumerasi.

[out] numEntriesReturned

Jumlah entri enumerasi yang dikembalikan.

Mengembalikan nilai

Mengembalikan kode/nilai Deskripsi
ERROR_SUCCESS
0		 SAs berhasil dijumlahkan.
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 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.

IPsecSaEnum1 berfungsi pada rekam jepret SAS yang diambil pada saat handel enumerasi dibuat.

IPsecSaEnum1 adalah implementasi spesifik dari IPsecSaEnum. 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