Función ZwQueryEaFile (ntifs.h)
Rutina de 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 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 FILE_FULL_EA_INFORMATIONbúfer de salida estructurado proporcionado por el autor de la llamada en el que se devuelven los EA del archivo.
[in] Length
Longitud, en bytes, del búfer al que apunta buffer.
[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 de FILE_GET_EA_INFORMATIONproporcionado por el autor de la llamada que especifica los EA 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
Establézcalo 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. |
Observaciones
La cantidad de información que ZwQueryEaFile devuelve se basa en el tamaño de las ENTIDADES de certificación y el tamaño del búfer al que búfer apunta. 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 EA completas en el búfer; nunca se devolverán entidades de certificación parciales.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 |
| de la plataforma de destino de |
Universal |
| encabezado de |
ntifs.h (include FltKernel.h, Ntifs.h) |
| biblioteca de |
NtosKrnl.lib |
| DLL de |
NtosKrnl.exe |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |