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.

Mengembalikan nilai

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 setiap aliran data ini, driver callout harus memanggil fungsi FwpsCalloutUnregisterByKey0 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 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 sampai semua callout yang sebelumnya terdaftar di mesin filter telah berhasil dibatalkan pendaftarannya.

Persyaratan

   
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