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

Статья
02/06/2025

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

Указатель объекта файла.

[out] ReturnedEaData

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

[in] Length

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

[in] ReturnSingleEntry

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

[in, optional] EaList

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

[in] EaListLength

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

[in, optional] EaIndex

Индекс записи, с которой начинается сканирование списка расширенных атрибутов файла. Этот параметр игнорируется, если параметр EaList указывает на список nonempty. Этот параметр является необязательным и может быть 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 возникла ошибка выделения пула. Это код ошибки.

Требования

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

См. также

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity

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