Fungsi FwpsCalloutUnregisterById0 (fwpsk.h)

Fungsi FwpsCalloutUnregisterById0 membatalkan pendaftaran callout dari mesin filter.

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

 

Sintaks

NTSTATUS FwpsCalloutUnregisterById0(
  [in] const UINT32 calloutId
);

Parameter

[in] calloutId

Pengidentifikasi run-time untuk callout yang tidak terdaftar dari mesin filter. Ini harus menjadi pengidentifikasi run-time yang dikembalikan ketika driver callout memanggil fungsi FwpsCalloutRegister0 atau FwpsCalloutRegister1 untuk mendaftarkan callout dengan mesin filter.

Nilai kembali

Fungsi FwpsCalloutUnregisterById0 mengembalikan salah satu kode NTSTATUS berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Callout berhasil dibatalkan pendaftarannya dari mesin filter.
STATUS_DEVICE_BUSY	Ada satu atau beberapa aliran data yang sedang diproses oleh callout yang memiliki konteks luar biasa yang terkait dengan aliran data. Driver callout harus memanggil fungsi FwpsFlowRemoveContext0 untuk setiap aliran data ini untuk menghapus konteks terkait. Setelah konteks berhasil dihapus dari setiap aliran data ini, driver callout harus memanggil fungsi FwpsCalloutUnregisterById0 lagi untuk menyelesaikan pembatalan pendaftaran callout dari mesin filter.
STATUS_FWP_CALLOUT_NOT_FOUND	Tidak ada callout yang terdaftar dengan mesin filter yang cocok dengan pengidentifikasi run-time yang ditentukan dalam parameter calloutId .
STATUS_FWP_IN_USE	Callout sudah dalam proses terdaftar atau tidak terdaftar di utas lain.
Kode status lainnya	Terjadi kesalahan.

Keterangan

Driver callout memanggil fungsi FwpsCalloutUnregisterById0 untuk membatalkan pendaftaran callout dari mesin filter, menggunakan pengidentifikasi run-time untuk mengidentifikasi callout yang tidak terdaftar. Fungsi ini berhasil bahkan jika ada filter di mesin filter yang menentukan callout untuk tindakan 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 setelah callout dibatalkan pendaftarannya dari mesin filter.

Driver callout tidak dapat dibongkar sampai semua callout yang sebelumnya terdaftar di mesin filter telah berhasil dibatalkan pendaftarannya.

Persyaratan

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

Lihat juga

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterByKey0

FwpsFlowRemoveContext0

Jenis Callout