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

  • Статья

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

Синтаксис

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

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

[in] ReturnSingleEntry

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

[in, optional] EaList

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

[in] EaListLength

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

[in, optional] EaIndex

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая FltKernel.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Правила соответствия DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

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

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile