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

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

См. также

FLT_TAG_DATA_BUFFER

FSCTL_DELETE_REPARSE_POINT

FSCTL_GET_REPARSE_POINT

FSCTL_SET_REPARSE_POINT

FltTagFile

IsReparseTagMicrosoft

IsReparseTagNameSurrogate

  • Last updated on