FilterUnload, fonction (fltuser.h)
Une application qui a chargé un minifiltre de prise en charge en appelant FilterLoad peut décharger le minifiltre en appelant la fonction FilterUnload .
Syntaxe
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
Paramètres
[in] lpFilterName
Pointeur vers une chaîne de caractères larges terminée par null contenant le même nom de minifiltre que celui passé à FilterLoad. Ce paramètre est obligatoire et ne peut pas être NULL ou une chaîne vide.
Valeur retournée
FilterUnload retourne S_OK en cas de réussite. Sinon, elle retourne une valeur d’erreur.
Remarques
FilterUnload est l’équivalent Win32 de FltUnloadFilter.
FilterUnload recherche un minifiltre inscrit dont le nom de service correspond au lpFilterName donné et appelle la routine FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) de ce minifilter.
Si le minifilter n’a pas inscrit de routine FilterUnloadCallback , l’appel à FilterUnload échoue.
Les appelants de FilterUnload doivent avoir SeLoadDriverPrivilege (lui-même de SE_LOAD_DRIVER_PRIVILEGE) pour charger ou décharger un pilote minifilter. Ce privilège est nommé par la constante de nom SE_LOAD_DRIVER_NAME. (Les privilèges sont décrits dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows pour Windows 7 et .NET Framework 4.0.)
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | fltuser.h (inclure Fltuser.h) |
| Bibliothèque | FltLib.lib |
| DLL | FltLib.dll |