Функция FilterUnload (fltuser.h)
Приложение, загрузив поддерживающий минифильтр, вызвав FilterLoad , может выгрузить минифильтр, вызвав функцию FilterUnload .
Синтаксис
HRESULT FilterUnload(
[in] LPCWSTR lpFilterName
);
Параметры
[in] lpFilterName
Указатель на строку расширенных символов, завершающуюся null, содержащую то же имя минифильтра, которое было передано в FilterLoad. Этот параметр является обязательным и не может иметь значение NULL или пустую строку.
Возвращаемое значение
FilterUnload возвращает S_OK в случае успешного выполнения. В противном случае возвращается значение ошибки.
Комментарии
FilterUnload — это эквивалент FltUnloadFilter в Win32.
FilterUnload ищет зарегистрированный минифильтр, имя службы которого соответствует заданному lpFilterName , и вызывает подпрограмму FilterUnloadCallback этого минифильтра (PFLT_FILTER_UNLOAD_CALLBACK).
Если минифильтр не зарегистрировал подпрограмму FilterUnloadCallback , вызов FilterUnload завершается ошибкой .
Вызывающие объект FilterUnload должны иметь SeLoadDriverPrivilege (LUID SE_LOAD_DRIVER_PRIVILEGE) для загрузки или выгрузки драйвера минифильтра. Эта привилегия называется константой имени SE_LOAD_DRIVER_NAME. (Привилегии описаны в документации microsoft Windows Software Development Kit (SDK) для Windows 7 и платформа .NET Framework 4.0.)
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | fltuser.h (включая Fltuser.h) |
| Библиотека | FltLib.lib |
| DLL | FltLib.dll |