Fungsi FwpmCalloutDeleteById0 (fwpmk.h)

Fungsi FwpmCalloutDeleteById0 menghapus callout dari mesin filter.

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

 

Sintaks

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT32 id
);

Parameter

[in] engineHandle

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

[in] id

Pengidentifikasi run-time untuk callout yang sedang dihapus dari mesin filter. Ini harus menjadi pengidentifikasi run-time yang dikembalikan ketika driver callout yang disebut fungsi FwpmCalloutAdd0 untuk menambahkan callout ke mesin filter.

Nilai kembali

Fungsi FwpmCalloutDeleteById0 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 panggilan untuk tindakan filter.
STATUS_FWP_CALLOUT_NOT_FOUND	Tidak ada callout di mesin filter yang cocok dengan pengidentifikasi run-time yang ditentukan dalam parameter id .
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout memanggil fungsi FwpmCalloutDeleteById0 untuk menghapus callout dari mesin filter, menggunakan pengidentifikasi run-time 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

FwpmCalloutDeleteByKey0

FwpmEngineOpen0