Fungsi FwpmCalloutAdd0 (fwpmk.h)

Artikel
08/07/2023

Fungsi FwpmCalloutAdd0 menambahkan callout ke mesin filter.

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

Sintaks

NTSTATUS FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] UINT32               *id
);

Parameter

[in] engineHandle

Handel untuk sesi terbuka ke mesin filter. Driver callout memanggil fungsi FwpmEngineOpen0 untuk membuka sesi ke mesin filter.

[in] callout

Penunjuk ke struktur FWPM_CALLOUT0 konstanta yang berisi data yang diperlukan untuk menambahkan callout ke mesin filter.

[in, optional] sd

Penunjuk ke struktur SECURITY_DESCRIPTOR konstanta yang menjelaskan deskriptor keamanan untuk callout yang ditambahkan ke mesin filter. Parameter ini bersifat opsional dan dapat berupa NULL.

[out, optional] id

Penunjuk ke variabel berjenis UINT32 yang menerima pengidentifikasi run-time yang mengidentifikasi callout di mesin filter. Ini adalah pengidentifikasi yang sama yang dikembalikan ketika driver callout mendaftarkan fungsi callout driver callout dengan mesin filter. Driver callout meneruskan pengidentifikasi ini ke fungsi FwpmCalloutDeleteById0 saat menghapus callout dari mesin filter. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Fungsi FwpmCalloutAdd0 mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Callout berhasil ditambahkan ke mesin filter.
STATUS_FWP_ALREADY_EXISTS	Callout tidak dapat ditambahkan ke mesin filter. Callout sudah ada di mesin filter dengan pengidentifikasi yang identik dengan GUID yang ditentukan dalam anggota calloutKey dari struktur FWPM_CALLOUT0 yang ditujukkan oleh parameter callout .
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout memanggil fungsi FwpmCalloutAdd0 untuk menambahkan callout ke mesin filter.

Driver callout biasanya tidak menambahkan callout mereka ke mesin filter. Dalam kebanyakan situasi, ini ditangani oleh aplikasi manajemen Windows Filtering Platform mode pengguna.

Callout dan filter yang menentukan callout untuk tindakan filter dapat ditambahkan ke mesin filter sebelum driver callout mendaftarkan callout dengan mesin filter. Dalam situasi ini, filter dengan jenis tindakan FWP_ACTION_CALLOUT_TERMINATING atau FWP_ACTION_CALLOUT_UNKNOWN diperlakukan sebagai FWP_ACTION_BLOCK dan filter dengan jenis tindakan FWP_ACTION_CALLOUT_INSPECTION diabaikan sampai callout terdaftar di mesin filter.

Persyaratan

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