Función FsRtlSetKernelEaFile (ntifs.h)

La rutina FsRtlQueryKernelEaFile se usa para establecer, modificar o eliminar valores de atributo extendido (EA) para un archivo y esperar sincrónicamente a que se complete, devolviendo un resultado. Establece el IRP_MN_KERNEL código secundario que permite que esta API establezca SecureEAs. Esto permite al autor de la llamada hacerlo mediante FileObject en lugar de un identificador.

Sintaxis

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

Parámetros

[in] FileObject

Puntero a un FileObject de para enviar la solicitud QueryEA.

[in] EaBuffer

Puntero a un búfer de entrada FILE_FULL_EA_INFORMATIONestructurado proporcionado por el autor de la llamada que contiene los valores de atributo extendidos que se van a establecer.

[in] Length

Especifica la longitud del búfer de EA.

Valor devuelto

La rutina FsRtlSetKernelEaFile recibe el estado de la operación y devuelve uno de los códigos de estado:

Código devuelto	Descripción
STATUS_EA_LIST_INCONSISTENT	El parámetro EaList no tiene el formato correcto.
STATUS_EAS_NOT_SUPPORTED	El sistema de archivos no admite atributos extendidos.
STATUS_INSUFFICIENT_RESOURCES	No se pudo asignar el paquete de solicitud de E/S (IRP) para esta solicitud.
STATUS_INTERMIXED_KERNEL_EA_OPERATION	La solicitud no puede mezclar normal y ea del kernel en la misma llamada.
STATUS_INVALID_DEVICE_REQUEST	Error en la solicitud, ya que era un dispositivo directo abierto.
STATUS_SUCCESS	La solicitud se realizó correctamente.

Observaciones

Esta rutina supone que todos los búferes pasados proceden del modo kernel.

Se pueden establecer, modificar o eliminar en una sola llamada a FsRtlSetKernelEaFile. Los EA normales también se pueden establecer mediante la función FsRtlSetKernelEaFile . Para eliminar EA, especifique un EAName de con un EaValueLength de cero. Puede mezclar la inserción de nuevos, modificar los existentes o quitar ea en una sola llamada.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 8
servidor mínimo admitido	Windows Server 2012
de la plataforma de destino de	Windows
encabezado de	ntifs.h

Consulte también

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile