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 |
|---|---|
|
El sistema de archivos no admite atributos extendidos. Se trata de un código de error. |
|
La instancia o el volumen se descomponen. Se trata de un código de error. |
|
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 |