Funzione FilterUnload (fltuser.h)
Un'applicazione che ha caricato un minifiltro di supporto chiamando FilterLoad può scaricare il minifilter chiamando la funzione FilterUnload .
Sintassi
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
Parametri
[in] lpFilterName
Puntatore a una stringa di caratteri wide-character con terminazione null contenente lo stesso nome minifilter passato a FilterLoad. Questo parametro è obbligatorio e non può essere NULL o una stringa vuota.
Valore restituito
FilterUnload restituisce S_OK se riuscito. In caso contrario, restituisce un valore di errore.
Commenti
FilterUnload è l'equivalente Win32 di FltUnloadFilter.
FilterUnload cerca un minifilter registrato il cui nome del servizio corrisponde alla determinata routine lpFilterName e chiama la routine FilterUnloadCallback del minifilter (PFLT_FILTER_UNLOAD_CALLBACK).
Se il minifilter non ha registrato una routine FilterUnloadCallback , la chiamata a FilterUnload ha esito negativo.
I chiamanti di FilterUnload devono avere SeLoadDriverPrivilege (LUID di SE_LOAD_DRIVER_PRIVILEGE) per caricare o scaricare un driver minifilter. Questo privilegio viene denominato dalla costante nome SE_LOAD_DRIVER_NAME. I privilegi sono descritti nella documentazione di Microsoft Windows Software Development Kit (SDK) per Windows 7 e .NET Framework 4.0.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | fltuser.h (include Fltuser.h) |
| Libreria | FltLib.lib |
| DLL | FltLib.dll |