Fungsi FwpsAleEndpointEnum0 (fwpsk.h)

  • Artikel

Fungsi FwpsAleEndpointEnum0 menghitung titik akhir penerapan lapisan aplikasi (ALE).

CatatanFwpsAleEndpointEnum0 adalah versi tertentu dari FwpsAleEndpointEnum. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.
 

Sintaks

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

Parameter

[in] engineHandle

Handel untuk sesi terbuka dengan mesin filter. Handel ini diperoleh ketika sesi dibuka dengan memanggil FwpmEngineOpen0.

[in] enumHandle

Handel enumerasi yang dibuat oleh panggilan sebelumnya ke FwpsAleEndpointDestroyEnumHandle0.

[in] numEntriesRequested

Jumlah maksimum entri properti titik akhir yang akan dikembalikan. Jumlah entri aktual yang dijumlahkan dikembalikan dalam numEntriesReturned. Angka aktual kurang dari angka yang diminta hanya jika lebih sedikit titik akhir daripada yang diminta.

[out] entries

Penunjuk ke array FWPS_ALE_ENDPOINT_PROPERTIES0 penunjuk struktur. Setiap struktur berisi properti dari satu titik akhir. Array berisi elemen sebanyak nilai yang dikembalikan dalam numEntriesReturned.

[out] numEntriesReturned

Saat dikembalikan, jumlah elemen dalam array struktur properti titik akhir yang ditujukan oleh entri.

Nilai kembali

Fungsi FwpsAleEndpointEnum0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Fungsi berhasil.
Kode status lainnya
 Terjadi kesalahan.

Keterangan

Untuk menghitung titik akhir ALE, driver callout harus terlebih dahulu mendapatkan handel enumerasi dengan memanggil FwpsAleEndpointCreateEnumHandle0. Handel yang dikembalikan dikaitkan dengan parameter apa pun yang ditentukan dalam parameter enumTemplate opsional dari FwpsAleEndpointCreateEnumHandle0.

Setelah mendapatkan handel, driver callout dapat memanggil FwpsAleEndpointEnum0 untuk mendapatkan informasi tentang titik akhir yang cocok dengan parameter enumerasi handel.

Setelah selesai memeriksa properti titik akhir, driver callout harus memanggil FwpsAleEndpointDestroyEnumHandle0 untuk merilis sumber daya sistem yang terkait dengan handel enumerasi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 7.
Target Platform Universal
Header fwpsk.h (termasuk Fwpsk.h)
Pustaka Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Lihat juga

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0