Функция ZwQueryEaFile (ntifs.h)

Статья
12/22/2024

подпрограмма ZwQueryEaFile возвращает расширенные атрибуты (EAs), связанные с указанным файлом.

Синтаксис

NTSTATUS ZwQueryEaFile(
  [in]           HANDLE           FileHandle,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [out]          PVOID            Buffer,
  [in]           ULONG            Length,
  [in]           BOOLEAN          ReturnSingleEntry,
  [in, optional] PVOID            EaList,
  [in]           ULONG            EaListLength,
  [in, optional] PULONG           EaIndex,
  [in]           BOOLEAN          RestartScan
);

Параметры

[in] FileHandle

Дескриптор файла, на котором выполняется операция.

[out] IoStatusBlock

Указатель на структуру IO_STATUS_BLOCK, которая получает окончательное состояние завершения и другие сведения о запрошенной операции.

[out] Buffer

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

[in] Length

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

[in] ReturnSingleEntry

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

[in, optional] EaList

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

[in] EaListLength

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

[in, optional] EaIndex

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

[in] RestartScan

Установите значение TRUE, если ZwQueryEaFile должен начать проверку при первой записи в списке EA файла. Если для этого параметра задано значение FALSE, подпрограмма возобновляет проверку с предыдущего вызова на ZwQueryEaFile.

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

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

Возвращаемое значение	Описание
STATUS_EAS_NOT_SUPPORTED	Файловая система не поддерживает EAS. Это код ошибки.
STATUS_INSUFFICIENT_RESOURCES	Для завершения операции недостаточно памяти. Это код ошибки.
STATUS_EA_LIST_INCONSISTENT	Параметр eaList неправильно отформатирован. Это код ошибки.

Замечания

Объем сведений, возвращаемых ZwQueryEaFile, зависит от размера EAs и размера буфера, на который указывает буфер. То есть все запрошенные EAs записываются в буфер, или буфер заполняется столько полных EAS, сколько недостаточно больших, чтобы содержать все EAs. Только полные EAs записываются в буфер; не будут возвращены частичные соглашения об уровне обслуживания.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000
целевая платформа	Всеобщий
заголовка	ntifs.h (include FltKernel.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
правил соответствия DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

См. также

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile

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