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

Статья
08/07/2023

FltQueryEaFile возвращает сведения о значениях расширенных атрибутов (EA) для файла.

Синтаксис

NTSTATUS FLTAPI FltQueryEaFile(
  [in]            PFLT_INSTANCE Instance,
  [in]            PFILE_OBJECT  FileObject,
  [out]           PVOID         ReturnedEaData,
  [in]            ULONG         Length,
  [in]            BOOLEAN       ReturnSingleEntry,
  [in, optional]  PVOID         EaList,
  [in]            ULONG         EaListLength,
  [in, optional]  PULONG        EaIndex,
  [in]            BOOLEAN       RestartScan,
  [out, optional] PULONG        LengthReturned
);

Параметры

[in] Instance

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

[in] FileObject

Указатель на объект file для файла.

[out] ReturnedEaData

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

[in] Length

Длина (в байтах) буфера, на который указывает параметр ReturnedEaData .

[in] ReturnSingleEntry

Задайте значение TRUE , если FltQueryEaFile должен возвращать только первую найденную запись.

[in, optional] EaList

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

[in] EaListLength

Длина (в байтах) буфера, на который указывает параметр EaList .

[in, optional] EaIndex

Индекс записи, с которой начинается сканирование списка расширенных атрибутов файла. Этот параметр игнорируется, если параметр EaList указывает на список непустый. Этот параметр является необязательным и может иметь значение NULL.

[in] RestartScan

Задайте значение TRUE , если FltQueryEaFile должен начать сканирование с первой записи в списке расширенных атрибутов файла. Если для этого параметра не задано значение TRUE, проверка возобновляется из предыдущего вызова FltQueryEaFile.

[out, optional] LengthReturned

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

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

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

Код возврата	Описание
STATUS_EAS_NOT_SUPPORTED	Файловая система не поддерживает расширенные атрибуты. Это код ошибки.
STATUS_FLT_DELETING_OBJECT	Экземпляр или том сносится. Это код ошибки.
STATUS_INSUFFICIENT_RESOURCES	FltQueryEaFile обнаружил сбой выделения пула. Это код ошибки.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в пакете обновления 1 для Microsoft Windows 2000 с пакетом обновления 1 (SP4), Windows XP с пакетом обновления 3 (SP3), Windows Server 2003 с пакетом обновления 1 (SP1) и более поздних версиях операционной системы Windows.
Целевая платформа	Универсальное
Верхняя часть	fltkernel.h (включая Fltkernel.h)
Библиотека	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

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

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity

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