Fungsi FwpsCalloutUnregisterById0 (fwpsk.h)
Fungsi FwpsCalloutUnregisterById0 membatalkan pendaftaran callout dari mesin filter.
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 |
|---|---|
|
Callout berhasil dibatalkan pendaftarannya dari mesin filter. |
|
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. |
|
Tidak ada callout yang terdaftar dengan mesin filter yang cocok dengan pengidentifikasi run-time yang ditentukan dalam parameter calloutId . |
|
Callout sudah dalam proses terdaftar atau tidak terdaftar di utas lain. |
|
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
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk