Função ZwSetEaFile (ntifs.h)
ZwSetEaFile substitui os EAs (atributos estendidos) associados a um arquivo pelos 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 FILE_FULL_EA_INFORMATION estruturado pelo chamador que contém os novos EAs que substituirão os EAs atualmente associados ao arquivo.
[in] Length
Comprimento, em bytes, do buffer para o qual o parâmetro Buffer aponta.
Retornar valor
ZwSetEaFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:
| Valor retornado | Descrição |
|---|---|
| STATUS_EA_LIST_INCONSISTENT | A lista de EA para a qual o 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. |
Comentários
ZwSetEaFile substitui os EAs associados ao FileHandle pelos EAs no buffer para o qual o Buffer aponta. Os EAs no buffer devem ser formatados como uma sequência de estruturas de FILE_FULL_EA_INFORMATION . ZwSetEaFileverifica primeiro se o buffer de valores EA é válido antes de substituir os EAs existentes.
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) |