Функция FilterDetach (fltuser.h)
Функция FilterDetach отсоединяет заданный экземпляр минифильтра от заданного тома.
Синтаксис
HRESULT FilterDetach(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName
);
Параметры
[in] lpFilterName
Указатель на строку расширенных символов, завершающуюся null, содержащую имя минифильтра, экземпляр которого должен быть отсоединен от стека. Этот параметр является обязательным и не может иметь значение NULL.
[in] lpVolumeName
Указатель на строку расширенных символов, завершающуюся null, содержащую имя тома, к которому в данный момент присоединен экземпляр.
Входная строка lpVolumeName может быть любой из следующих. Обратная косая черта в конце (\) является необязательной.
- Буква диска, например "D:\"
- Путь к точке подключения тома, например "c:\mnt\edrive\"
- Уникальный идентификатор тома (также называемый именем GUID тома), например "\?? \Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- Неперсистентное имя устройства (также называемое целевым именем или именем устройства NT), например \Device\HarddiskVolume1\".
[in, optional] lpInstanceName
Указатель на строку расширенных символов, завершающуюся null, содержащую имя экземпляра, который должен быть удален. Этот параметр является необязательным и может иметь значение NULL. Если значение равно NULL, удаляется экземпляр с наибольшим соответствием.
Возвращаемое значение
FilterDetach возвращает S_OK в случае успешного выполнения. В противном случае возвращается значение ошибки.
Комментарии
FilterDetach — это эквивалент Win32 FltDetachVolume.
FilterDetach отсоединяет экземпляр минифильтра от тома и удаляет экземпляр.
Чтобы подключить экземпляр минифильтра к тому, вызовите FilterAttach или FilterAttachAtAltitude.
Требования
| Целевая платформа | Универсальное |
| Верхняя часть | fltuser.h (включая Fltuser.h) |
| Библиотека | FltLib.lib |
| DLL | FltLib.dll |