Função ZwSetEaFile (ntifs.h)
ZwSetEaFile substitui os EAs (atributos estendidos) associados a um arquivo com os EAs especificados.
Sintaxe
NTSTATUS ZwSetEaFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[in] PVOID Buffer,
[in] ULONG Length
);
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.
[in] Buffer
Um ponteiro para um buffer de entrada estruturado FILE_FULL_EA_INFORMATIONfornecido pelo chamador que contém os novos EAs que substituirão os EAs atualmente associados ao arquivo.
[in] Length
Comprimento, em bytes, do buffer ao qual o buffer parâmetro aponta.
Valor de retorno
ZwSetEaFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:
| Valor de retorno | Descrição |
|---|---|
| STATUS_EA_LIST_INCONSISTENT | A lista de EA à qual buffer aponta não está formatada corretamente. 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. |
Observações
ZwSetEaFile substitui os EAs associados a FileHandle pelos EAs no buffer que buffer aponta. Os EAs no buffer devem ser formatados como uma sequência de estruturas de FILE_FULL_EA_INFORMATION. ZwSetEaFile primeiro verifica se o buffer de valores EA é válido antes de substituir os EAs existentes.
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) |