Функция FilterDetach (fltuser.h)

Статья
08/23/2023

Функция 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\".

Этот параметр является обязательным и не может иметь значение NULL.

[in, optional] lpInstanceName

Указатель на строку расширенных символов, завершающуюся null, содержащую имя экземпляра, который должен быть удален. Этот параметр является необязательным и может иметь значение NULL. Если значение равно NULL, удаляется экземпляр с наибольшим соответствием.

Возвращаемое значение

FilterDetach возвращает S_OK в случае успешного выполнения. В противном случае возвращается значение ошибки.

Требования


Целевая платформа	Универсальное
Верхняя часть	fltuser.h (включая Fltuser.h)
Библиотека	FltLib.lib
DLL	FltLib.dll

См. также раздел

FilterAttach

FilterAttachAtAltitude

FltDetachVolume

Поделиться через