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

ZwSetEaFile заменяет расширенные атрибуты , связанные с файлом, указанными 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

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

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

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

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

Комментарии

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

Требования

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

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

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile