Función FsRtlQueryKernelEaFile (ntifs.h)

La rutina FsRtlQueryKernelEaFile se usa para crear una solicitud QueryEA explícita y esperar sincrónicamente a que se complete, devolviendo el resultado. Esto permite al autor de la llamada hacerlo mediante FileObject en lugar de un identificador.

Sintaxis

NTSTATUS FsRtlQueryKernelEaFile(
  [in]            PFILE_OBJECT FileObject,
  [out]           PVOID        ReturnedEaData,
  [in]            ULONG        Length,
  [in]            BOOLEAN      ReturnSingleEntry,
  [in]            PVOID        EaList,
  [in]            ULONG        EaListLength,
  [in, optional]  PULONG       EaIndex,
  [in]            BOOLEAN      RestartScan,
  [out, optional] PULONG       LengthReturned
);

Parámetros

[in] FileObject

Puntero a un FileObject de para enviar la solicitud QueryEA.

[out] ReturnedEaData

Puntero a un FILE_FULL_EA_INFORMATIONbúfer de salida estructurado proporcionado por el autor de la llamada, donde se devolverán los valores de atributo extendidos.

[in] Length

Especifica la longitud, en bytes, de ReturnedEaData

[in] ReturnSingleEntry

Especifica si solo se debe devolver una sola entrada en lugar de rellenar el búfer con tantas entidades de certificación como sea posible.

[in] EaList

Puntero a un FILE_GET_EA_INFORMATIONbúfer de entrada estructurado proporcionado por el autor de la llamada, que especifica los atributos extendidos que se van a consultar. Este parámetro es opcional y se puede NULL.

[in] EaListLength

Especifica la longitud de EaList, si se proporcionó una lista de EA.

[in, optional] EaIndex

Proporciona el índice opcional de un EA cuyo valor se va a devolver. Si se especifica, solo se devuelve ea.

[in] RestartScan

Especifica si se debe reiniciar el examen de las entidades de certificación desde el principio.

[out, optional] LengthReturned

Especifica la cantidad de datos válidos que se devuelven en el búfer de ReturnedEaData.

Valor devuelto

La rutina FsRtlQueryKernelEaFile devuelve uno de los códigos de estado:

Código devuelto	Descripción
STATUS_EAS_NOT_SUPPORTED	El sistema de archivos no admite atributos extendidos.
STATUS_INVALID_DEVICE_REQUEST	Error en la solicitud, ya que era un dispositivo directo abierto.
STATUS_INSUFFICIENT_RESOURCES	No se pudo asignar el paquete de solicitud de E/S (IRP) para esta solicitud.
STATUS_SUCCESS	La solicitud se realizó correctamente.

Observaciones

Esta rutina FsRtlQueryKernelEaFile supone que todos los búferes pasados se encuentran en modo kernel, ya que requiere que los búferes de entrada y salida especificados sean direcciones de modo kernel. Se producirá un error en la operación si se especifica una dirección en modo de usuario.

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

FsRtlSetKernelEaFile

ZwQueryEaFile

ZwSetEaFile