Función ZwQueryEaFile (ntifs.h)
La rutina ZwQueryEaFile devuelve los atributos extendidos (EAs) asociados al archivo especificado.
Sintaxis
NTSTATUS ZwQueryEaFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID Buffer,
[in] ULONG Length,
[in] BOOLEAN ReturnSingleEntry,
[in, optional] PVOID EaList,
[in] ULONG EaListLength,
[in, optional] PULONG EaIndex,
[in] BOOLEAN RestartScan
);
Parámetros
[in] FileHandle
Identificador del archivo en el que se va a realizar la operación.
[out] IoStatusBlock
Puntero a una estructura de IO_STATUS_BLOCK que recibe el estado de finalización final y otra información sobre la operación solicitada.
[out] Buffer
Puntero a un búfer de salida estructurado FILE_FULL_EA_INFORMATION proporcionado por el autor de la llamada en el que se van a devolver los EAs del archivo.
[in] Length
Longitud, en bytes, del búfer al que apunta el búfer .
[in] ReturnSingleEntry
Se establece en TRUE si ZwQueryEaFile debe devolver solo la primera entrada que 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 EAs 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 debe comenzar el examen de la lista ea del archivo. Este parámetro se omite si EaList apunta a una lista no vacía. Este parámetro es opcional y puede ser NULL.
[in] RestartScan
Se establece en TRUE si ZwQueryEaFile debe comenzar el examen en la primera entrada de la lista ea del archivo. Si este parámetro se establece en FALSE, la rutina reanuda el examen de una llamada anterior a ZwQueryEaFile.
Valor devuelto
ZwQueryEaFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente:
| Valor devuelto | Descripción |
|---|---|
| STATUS_EAS_NOT_SUPPORTED | El sistema de archivos no admite EAs. Se trata de un código de error. |
| STATUS_INSUFFICIENT_RESOURCES | No hay suficiente memoria disponible para completar la operación. Se trata de un código de error. |
| STATUS_EA_LIST_INCONSISTENT | El parámetro EaList no tiene el formato correcto. Se trata de un código de error. |
Comentarios
La cantidad de información que devuelve ZwQueryEaFile se basa en el tamaño de las entidades de certificación y el tamaño del búfer al que apunta buffer . Es decir, todas las entidades de certificación solicitadas se escriben en el búfer o el búfer se rellena con tantas entidades de certificación completas si no es lo suficientemente grande como para contener todas las entidades de certificación. Solo se escriben EAs completas en el búfer; nunca se devolverán EAs parciales.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 |
| Plataforma de destino | Universal |
| Encabezado | ntifs.h (incluya FltKernel.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |