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

Статья
12/21/2024

Подпрограмма FsRtlQueryKernelEaFile используется для задания, изменения и удаления расширенных значений атрибутов (EA) для файла и синхронно ожидая завершения, возвращая результат. Он задает IRP_MN_KERNEL дополнительный код, позволяющий этому API задавать SecureEAs. Это позволяет вызывающему объекту выполнять это с помощью FileObject вместо дескриптора.

Синтаксис

NTSTATUS FsRtlSetKernelEaFile(
  [in] PFILE_OBJECT FileObject,
  [in] PVOID        EaBuffer,
  [in] ULONG        Length
);

Параметры

[in] FileObject

Указатель на FileObject для отправки запроса QueryEA.

[in] EaBuffer

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

[in] Length

Указывает длину буфера EA.

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

Подпрограмма FsRtlSetKernelEaFile получает состояние операции и возвращает один из кодов состояния:

Возвращаемый код	Описание
STATUS_EA_LIST_INCONSISTENT	Параметр EaList неправильно отформатирован.
STATUS_EAS_NOT_SUPPORTED	Файловая система не поддерживает расширенные атрибуты.
STATUS_INSUFFICIENT_RESOURCES	Пакет запроса ввода-вывода (IRP) не может быть выделен для этого запроса.
STATUS_INTERMIXED_KERNEL_EA_OPERATION	Запрос не может взаимодействовать с обычным и ядром EA в том же вызове.
STATUS_INVALID_DEVICE_REQUEST	Запрос завершился ошибкой, так как он был открытым на прямом устройстве.
STATUS_SUCCESS	Запрос выполнен успешно.

Замечания

Эта подпрограмма предполагает, что все переданные в буферах буферы находятся в режиме ядра.

Одно или несколько модулей EA ядра могут быть заданы, изменены и (или) удалены в одном вызове FsRtlSetKernelEaFile. Обычные ea также можно задать с помощью функции FsRtlSetKernelEaFile. Вы удаляете EA, указав EAName с EaValueLength нуля. Вы можете перемешивание вставки новых, изменение существующих или удаление EA в одном вызове.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8
минимальный поддерживаемый сервер	Windows Server 2012
целевая платформа	Виндоус
заголовка	ntifs.h

См. также

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile

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