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 enviará la operación de 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 FILE_FULL_EA_INFORMATIONproporcionado 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

Establézcalo en TRUE si fltQueryEaFile debe devolver solo la primera entrada que se encuentra.

[in, optional] 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

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 comenzar 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 se puede NULL.

[in] RestartScan

Establézcalo 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 de ReturnedEaData. Este parámetro es opcional y se puede NULL.

Valor devuelto

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

Requisitos

Consulte también

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

fltSetEaFile de

ioCheckEaBufferValidity