Função ZwSetEaFile (ntifs.h)

  • Artigo

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)

Confira também

FILE_FULL_EA_INFORMATION

IoCheckEaBufferValidity

ZwQueryEaFile