Função ZwQueryEaFile (ntifs.h)

  • Artigo

A rotina ZwQueryEaFile retorna informações sobre valores de atributo estendido (EA) para um arquivo.

Sintaxe

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

O identificador do arquivo no qual a operação deve ser executada.

[out] IoStatusBlock

Um ponteiro para uma estrutura IO_STATUS_BLOCK que recebe o status de conclusão final e outras informações sobre a operação solicitada.

[out] Buffer

Um ponteiro para um buffer de saída estruturado FILE_FULL_EA_INFORMATION fornecido pelo chamador, em que os valores de atributo estendido devem ser retornados.

[in] Length

O comprimento, em bytes, do buffer para o qual o parâmetro Buffer aponta.

[in] ReturnSingleEntry

Defina como TRUE se ZwQueryEaFile deve retornar apenas a primeira entrada encontrada.

[in, optional] EaList

Um ponteiro para um buffer de entrada FILE_GET_EA_INFORMATION estruturado pelo chamador, que especifica os atributos estendidos a serem consultados. Esse parâmetro é opcional e pode ser NULL.

[in] EaListLength

O comprimento, em bytes, do buffer para o qual o parâmetro EaList aponta.

[in, optional] EaIndex

O índice da entrada na qual a verificação da lista de atributos estendidos do arquivo deve começar. Esse parâmetro será ignorado se o parâmetro EaList apontar para uma lista não íntegra. Esse parâmetro é opcional e pode ser NULL.

[in] RestartScan

Defina como TRUE se ZwQueryEaFile deve iniciar a verificação na primeira entrada na lista de atributos estendidos do arquivo. Se esse parâmetro for definido como FALSE, a rotina retomará a verificação de uma chamada anterior para ZwQueryEaFile.

Retornar valor

ZwQueryEaFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Valor retornado Descrição
STATUS_EAS_NOT_SUPPORTED
 O sistema de arquivos não dá suporte a atributos estendidos. Este é um código de erro.
STATUS_INSUFFICIENT_RESOURCES
 A rotina ZwQueryEaFile encontrou uma falha de alocação de pool. Este é um código de erro.
STATUS_EA_LIST_INCONSISTENT
 O parâmetro EaList não está formatado corretamente. Este é um código de erro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua FltKernel.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Confira também

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

ZwSetEaFile