Fungsi FwpmCalloutDeleteByKey0 (fwpmk.h)

Fungsi FwpmCalloutDeleteByKey0 menghapus callout dari mesin filter.

CatatanFwpmCalloutDeleteByKey0 adalah versi spesifik dari FwpmCalloutDeleteByKey. Lihat Nama Version-Independent WFP dan Menargetkan Versi Windows Tertentu untuk informasi selengkapnya.

 

Sintaks

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

Parameter

[in] engineHandle

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

[in] key

Pointer ke GUID yang secara unik mengidentifikasi callout yang sedang dihapus dari mesin filter. Ini harus menjadi penunjuk ke GUID yang sama yang ditentukan ketika driver callout yang disebut fungsi FwpmCalloutAdd0 untuk menambahkan callout ke mesin filter.

Nilai kembali

Fungsi FwpmCalloutDeleteByKey0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Callout berhasil dihapus dari mesin filter.
STATUS_FWP_IN_USE	Satu atau beberapa filter di mesin filter menentukan callout untuk tindakan filter.
STATUS_FWP_CALLOUT_NOT_FOUND	Tidak ada callout di mesin filter yang cocok dengan GUID yang ditentukan dalam parameter kunci .
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout memanggil fungsi FwpmCalloutDeleteByKey0 untuk menghapus callout dari mesin filter, menggunakan kunci GUID untuk mengidentifikasi callout yang akan dihapus.

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

Callout dapat dihapus dari mesin filter hanya jika tidak ada filter di mesin filter yang menentukan callout untuk tindakan 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

Lihat juga

FwpmCalloutAdd0

FwpmCalloutDeleteById0

FwpmEngineOpen0