Función ZwQueryEaFile (ntifs.h)

  • Artículo

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

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, donde se devolverán los valores de atributo extendidos.

[in] Length

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

[in] ReturnSingleEntry

Se establece en TRUE si ZwQueryEaFile 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 debe comenzar el examen de 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 ZwQueryEaFile debe comenzar el examen en la primera entrada de la lista de atributos extendidos 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 atributos extendidos. Se trata de un código de error.
STATUS_INSUFFICIENT_RESOURCES
 La rutina ZwQueryEaFile encontró un error de asignación de grupo. 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.

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)

Consulte también

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile