FilterUnload, fonction (fltuser.h)

Article
02/29/2024

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.)