Fungsi FilterUnload (fltuser.h)
Aplikasi yang telah memuat minifilter pendukung dengan memanggil FilterLoad dapat membongkar minifilter dengan memanggil fungsi FilterUnload .
Sintaks
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
Parameter
[in] lpFilterName
Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama minifilter yang sama yang diteruskan ke FilterLoad. Parameter ini diperlukan dan tidak boleh NULL atau string kosong.
Nilai kembali
FilterUnload mengembalikan S_OK jika berhasil. Jika tidak, ia mengembalikan nilai kesalahan.
Keterangan
FilterUnload setara dengan Win32 dari FltUnloadFilter.
FilterUnload mencari minifilter terdaftar yang nama layanannya cocok dengan lpFilterName yang diberikan dan memanggil rutinitas FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) minifilter.
Jika minifilter tidak mendaftarkan rutinitas FilterUnloadCallback , panggilan ke FilterUnload gagal.
Pemanggil FilterUnload harus memiliki SeLoadDriverPrivilege (LUID SE_LOAD_DRIVER_PRIVILEGE) untuk memuat atau membongkar driver minifilter. Hak istimewa ini dinamai oleh konstanta nama SE_LOAD_DRIVER_NAME. (Hak istimewa dijelaskan dalam Microsoft Windows Software Development Kit (SDK) untuk dokumentasi Windows 7 dan .NET Framework 4.0.)
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | fltuser.h (termasuk Fltuser.h) |
| Pustaka | FltLib.lib |
| DLL | FltLib.dll |