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