Fungsi IkeextSaEnum2 (fwpmu.h)

Artikel
08/23/2023

Fungsi IkeextSaEnum2 mengembalikan halaman hasil berikutnya dari enumerator asosiasi keamanan IKE/AuthIP (SA).

CatatanIkeextSaEnum2 adalah implementasi spesifik dari IkeextSaEnum yang digunakan di Windows 8. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya. Untuk Windows 7, IkeextSaEnum1 tersedia. Untuk Windows Vista, IkeextSaEnum0 tersedia.

Sintaks

DWORD IkeextSaEnum2(
  [in]  HANDLE             engineHandle,
  [in]  HANDLE             enumHandle,
  [in]  UINT32             numEntriesRequested,
  [out] IKEEXT_SA_DETAILS2 ***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 IKE/AuthIP SA. Panggil IkeextSaCreateEnumHandle0 untuk mendapatkan handel enumerasi.

[in] numEntriesRequested

Jenis: UINT32

Jumlah entri enumerasi yang diminta.

[out] entries

Jenis: IKEEXT_SA_DETAILS2***

Alamat entri enumerasi.

[out] numEntriesReturned

Jenis: UINT32*

Jumlah entri enumerasi yang dikembalikan.

Menampilkan nilai

Jenis: DWORD

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.
*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.

IkeextSaEnum2 bekerja pada rekam jepret SAs yang diambil pada saat handel enumerasi dibuat.

Persyaratan


Klien minimum yang didukung	Windows 8 [hanya 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

IKEEXT_SA_DETAILS2

IkeextSaCreateEnumHandle0

Bagikan melalui