Función FltQueryEaFile (fltkernel.h)

FltQueryEaFile devuelve información sobre los valores de atributo extendido (EA) de un archivo.

Sintaxis

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

Parámetros

[in] Instance

Puntero de instancia opaco para la instancia del controlador de minifiltro a la que se va a enviar la operación QueryEa . La instancia debe adjuntarse al volumen donde reside el archivo.

[in] FileObject

Puntero de objeto de archivo para el archivo.

[out] ReturnedEaData

Puntero a un búfer de entrada estructurado de FILE_FULL_EA_INFORMATION proporcionado por el autor de la llamada donde se van a devolver los valores de atributo extendidos.

[in] Length

Longitud, en bytes, del búfer al que apunta el parámetro ReturnedEaData .

[in] ReturnSingleEntry

Se establece en TRUE si FltQueryEaFile debe devolver solo la primera entrada que se encuentra.

[in, optional] EaList

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

[in] EaListLength

Longitud, en bytes, del búfer al que apunta el parámetro EaList .

[in, optional] EaIndex

Índice de la entrada en la que se va a empezar a examinar la lista de atributos extendidos del archivo. Este parámetro se omite si el parámetro EaList apunta a una lista no vacía. Este parámetro es opcional y puede ser NULL.

[in] RestartScan

Se establece en TRUE si FltQueryEaFile debe comenzar el examen en la primera entrada de la lista de atributos extendidos del archivo. Si este parámetro no está establecido en TRUE, el examen se reanuda desde una llamada anterior a FltQueryEaFile.

[out, optional] LengthReturned

Puntero a una variable asignada por el autor de la llamada que recibe el tamaño, en bytes, de la información devuelta en el búfer ReturnedEaData . Este parámetro es opcional y puede ser NULL.

Valor devuelto

FltQueryEaFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:

Código devuelto	Descripción
STATUS_EAS_NOT_SUPPORTED	El sistema de archivos no admite atributos extendidos. Se trata de un código de error.
STATUS_FLT_DELETING_OBJECT	La instancia o el volumen se descomponen. Se trata de un código de error.
STATUS_INSUFFICIENT_RESOURCES	FltQueryEaFile encontró un error de asignación de grupo. Se trata de un código de error.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en el paquete acumulativo de actualizaciones 1 de Microsoft Windows 2000 para SP4, Windows XP SP3, Windows Server 2003 SP1 y versiones posteriores del sistema operativo Windows.
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	FltMgr.lib
Archivo DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Consulte también

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity