Fungsi FwpsCalloutUnregisterByKey0 (fwpsk.h)

Fungsi FwpsCalloutUnregisterByKey0 membatalkan pendaftaran callout dari mesin filter.

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

 

Sintaks

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

Parameter

[in] calloutKey

Pointer ke GUID yang secara unik mengidentifikasi callout yang tidak terdaftar dari mesin filter. Ini harus menjadi penunjuk ke GUID yang sama yang ditentukan ketika driver callout memanggil fungsi FwpsCalloutRegister0 atau FwpsCalloutRegister1 untuk mendaftarkan callout dengan mesin filter.

Nilai kembali

Fungsi FwpsCalloutUnregisterByKey0 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 masing-masing aliran data ini, driver callout harus memanggil fungsi FwpsCalloutUnregisterByKey0 lagi untuk menyelesaikan membatalkan pendaftaran callout dari mesin filter.
STATUS_FWP_CALLOUT_NOT_FOUND	Tidak ada callout yang terdaftar dengan mesin filter yang cocok dengan GUID yang ditentukan dalam parameter calloutKey .
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 FwpsCalloutUnregisterByKey0 untuk membatalkan pendaftaran callout dari mesin filter, menggunakan kunci GUID 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 hingga 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

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

Jenis Callout