Função ZwQueryEaFile (ntifs.h)
rotina de ZwQueryEaFile retorna os EAs (atributos estendidos) 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_INFORMATIONestruturado pelo chamador no qual retornar os EAs do arquivo.
[in] Length
O comprimento, em bytes, do buffer que buffer aponta para.
[in] ReturnSingleEntry
Defina como TRUE se ZwQueryEaFile deverá retornar apenas a primeira entrada encontrada.
[in, optional] EaList
Um ponteiro para um buffer de entrada estruturado FILE_GET_EA_INFORMATIONfornecido 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ã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 EA do arquivo. Se esse parâmetro for definido como FALSE, a rotina retomará a verificação de uma chamada anterior para ZwQueryEaFile.
Valor de retorno
ZwQueryEaFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:
| Valor de retorno | 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. |
Observações
A quantidade de informações que ZwQueryEaFile retorna é baseada no tamanho dos EAs e no tamanho do buffer para o qual 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 |
|---|---|
| de cliente com suporte mínimo | Windows 2000 |
| da Plataforma de Destino |
Universal |
| cabeçalho | ntifs.h (inclua FltKernel.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL |
NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |