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

Статья
08/07/2023

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

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

[in, optional] Guid

Глобальный уникальный идентификатор (GUID), который однозначно идентифицирует тип точки повторного преобразования. Если FileTag не является тегом Майкрософт, этот параметр является обязательным и не может иметь значение NULL. Guid, указанный в этом параметре, должен соответствовать ИДЕНТИФИКАТОРу GUID точки повторной аналитики, необходимой для удаления.

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

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

Код возврата	Описание
STATUS_IO_REPARSE_TAG_MISMATCH	Тег reparse, указанный вызывающим объектом, не соответствует тегу удаляемой точки повторного обработки. Это код ошибки.
STATUS_REPARSE_ATTRIBUTE_CONFLICT	Идентификатор GUID повторного обработки, указанный вызывающим объектом, не совпадает с ИДЕНТИФИКАТОРом GUID удаляемой точки повторного обработки. Это код ошибки.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL