Функция FilterCreate (fltuser.h)
Функция FilterCreate создает дескриптор для заданного минифильтра.
Синтаксис
HRESULT FilterCreate(
[in] LPCWSTR lpFilterName,
[out] HFILTER *hFilter
);
Параметры
[in] lpFilterName
Указатель на строку расширенных символов, завершающуюся null, содержащую имя мини-фильтра. Этот параметр является обязательным и не может иметь значение NULL.
[out] hFilter
Указатель на переменную, выделенную вызывающим объектом, которая получает дескриптор для минифильтра, если вызов FilterCreate завершается успешно; в противном случае он получает INVALID_HANDLE_VALUE.
Возвращаемое значение
FilterCreate возвращает S_OK в случае успешного выполнения. В противном случае возвращается значение ошибки.
Комментарии
Приложение пользовательского режима вызывает FilterCreate , чтобы создать дескриптор, который можно использовать для взаимодействия с минифильтром режима ядра. Возвращенный дескриптор минифильтра можно передать в качестве параметра в такие функции, как FilterGetInformation.
Чтобы закрыть дескриптор фильтра, возвращенный FilterCreate, вызовите FilterClose.
Требования
| Целевая платформа | Универсальное |
| Верхняя часть | fltuser.h (включая Fltuser.h) |
| Библиотека | FltLib.lib |
| DLL | FltLib.dll |