Функция FltUntagFile (fltkernel.h)

Статья
02/06/2025

FltUntagFile удаляет точку перепара из файла или каталога.

Синтаксис

NTSTATUS FLTAPI FltUntagFile(
  [in]           PFLT_INSTANCE InitiatingInstance,
  [in]           PFILE_OBJECT  FileObject,
  [in]           ULONG         FileTag,
  [in, optional] GUID          *Guid
);

Параметры

[in] InitiatingInstance

Указатель непрозрачного экземпляра для экземпляра драйвера мини-фильтра, инициирующего этот запрос ввода-вывода. Этот параметр является обязательным и не может быть null.

[in] FileObject

Указатель на объект файла или каталога, из которого необходимо удалить точку повторного выполнения. Объект файла должен быть открыт для FILE_WRITE_DATA доступа. Этот параметр является обязательным и не может быть null.

[in] FileTag

Тег точки reparse. Тег, указанный в этом параметре, должен соответствовать тегу точки повторногоparse, который необходимо удалить.

[in, optional] Guid

Глобальный уникальный идентификатор (GUID), который однозначно идентифицирует тип точки повторного использования. Если FileTag не является тегом Майкрософт, этот параметр является обязательным и не может быть значение NULL. Идентификатор GUID, указанный в этом параметре, должен соответствовать GUID точки повторногоparse, чтобы удалить ее.

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

FltUntagFile возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих:

Возвращаемый код	Описание
STATUS_IO_REPARSE_TAG_MISMATCH	Тег reparse, указанный вызывающим элементом, не совпадал с тегом точки повторного обработки, которую нужно удалить. Это код ошибки.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Идентификатор GUID повторногоparse, указанный вызывающим оператором, не соответствовал GUID удаленной точки повторной обработки. Это код ошибки.

Замечания

Драйверы минифильтра должны использовать FltUntagFile вместо FSCTL_DELETE_REPARSE_POINT для удаления точки повторного анализа.

Драйвер минифильтра может задать тег повторного анализа в файле или каталоге, вызвав FltTagFile.

Дополнительные сведения о точках повторного анализа см. в документации по пакету SDK для Microsoft Windows.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	fltkernel.h (include Fltkernel.h)
библиотеки	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL