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

Статья
12/21/2024

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

Синтаксис

NTSTATUS ZwSetEaFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PVOID            Buffer,
  [in]  ULONG            Length
);

Параметры

[in] FileHandle

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

[out] IoStatusBlock

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

[in] Buffer

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

[in] Length

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

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

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

Возвращаемое значение	Описание
STATUS_EA_LIST_INCONSISTENT	Список EA, на который буфер указывает неправильно. Это код ошибки.
STATUS_INSUFFICIENT_RESOURCES	Для завершения операции недостаточно памяти. Это код ошибки.

Замечания

ZwSetEaFile заменяет EAs, связанные с FileHandle, на EAs в буфере, на который буфер указывает. EAs в буфере должны быть отформатированы в виде последовательности FILE_FULL_EA_INFORMATION структур. ZwSetEaFile сначала проверяет, является ли буфер значений EA допустимым перед заменой существующих 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

IoCheckEaBufferValidity

ZwQueryEaFile

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