Função FsRtlSetKernelEaFile (ntifs.h)

  • Artigo

O FsRtlQueryKernelEaFile de rotina é usado para definir, modificar e/ou excluir valores de atributo estendido (EA) para um arquivo e aguardar síncronamente para que ele seja concluído, retornando um resultado. Ele define o IRP_MN_KERNEL código secundário que permite que essa API defina SecureEAs. Isso permite que o chamador faça isso por FileObject em vez de um identificador.

Sintaxe

NTSTATUS FsRtlSetKernelEaFile(
  [in] PFILE_OBJECT FileObject,
  [in] PVOID        EaBuffer,
  [in] ULONG        Length
);

Parâmetros

[in] FileObject

Um ponteiro para um FileObject para o qual enviar a solicitação QueryEA.

[in] EaBuffer

Um ponteiro para um buffer de entrada FILE_FULL_EA_INFORMATION fornecido pelo chamador que contém os valores de atributo estendidos a serem definidos

[in] Length

Especifica o comprimento do buffer EA.

Retornar valor

O FsRtlSetKernelEaFile de rotina recebe a status da operação e retorna um dos códigos de status:

Código de retorno Descrição
STATUS_EA_LIST_INCONSISTENT
O parâmetro EaList não está formatado corretamente.
STATUS_EAS_NOT_SUPPORTED
O sistema de arquivos não dá suporte a atributos estendidos.
STATUS_INSUFFICIENT_RESOURCES
 O IRP (pacote de solicitação de E/S) não pôde ser alocado para essa solicitação.
STATUS_INTERMIXED_KERNEL_EA_OPERATION
 A solicitação não pode intermixar EAs normais e kernel na mesma chamada.
STATUS_INVALID_DEVICE_REQUEST
 A solicitação falhou porque era um dispositivo direto aberto.
STATUS_SUCCESS
 A solicitação foi bem-sucedida.

Comentários

Essa rotina pressupõe que todos os buffers passados sejam do modo kernel.

Um ou mais EA do Kernel podem ser definidos, modificados e/ou excluídos em uma única chamada para FsRtlSetKernelEaFile. Os EA normais também podem ser definidos usando a função FsRtlSetKernelEaFile . Exclua EA especificando um EAName com um EaValueLength de zero. Você pode intermixar inserindo novos, modificando existentes ou removendo EA em uma única chamada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho ntifs.h

Confira também

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile