Función ZwQueryEaFile (ntifs.h)

  • Artículo

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)

Consulte también

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile