Функция 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) |