Função ZwQueryEaFile (ntifs.h)
A rotina ZwQueryEaFile retorna os atributos estendidos (EAs) associados ao arquivo especificado.
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 FILE_FULL_EA_INFORMATION estruturado pelo chamador no qual retornar os EAs do arquivo.
[in] Length
O comprimento, em bytes, do buffer para o qual o Buffer aponta.
[in] ReturnSingleEntry
Defina como TRUE se ZwQueryEaFile deve retornar apenas a primeira entrada que encontrar.
[in, optional] EaList
Um ponteiro para um buffer de entrada FILE_GET_EA_INFORMATION estruturado pelo chamador que especifica os EAs 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 EA do arquivo deve começar. Esse parâmetro será ignorado se EaList apontar para uma lista nãompty. 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 EA 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 EAs. Este é um código de erro. |
| STATUS_INSUFFICIENT_RESOURCES | Não há memória suficiente disponível para concluir a operação. 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. |
Comentários
A quantidade de informações que ZwQueryEaFile retorna é baseada no tamanho dos EAs e no tamanho do buffer para o qual o Buffer aponta. Ou seja, todos os EAs solicitados são gravados no buffer ou o buffer é preenchido com tantos EAs completos se ele não for grande o suficiente para conter todos os EAs. Somente os EAs completos são gravados no buffer; nenhum EAs parcial será retornado.
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) |