Função FsRtlSetKernelEaFile (ntifs.h)

Artigo
12/21/2024

A rotina FsRtlQueryKernelEaFile é usada 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 estruturado FILE_FULL_EA_INFORMATIONfornecido pelo chamador que contém os valores de atributo estendido a serem definidos

[in] Length

Especifica o comprimento do buffer EA.

Valor de retorno

A rotina FsRtlSetKernelEaFile recebe o 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, pois era um dispositivo direto aberto.
STATUS_SUCCESS	A solicitação foi bem-sucedida.

Observações

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. Você exclui EA especificando um EAName com um EaValueLength zero. Você pode intermixar a inserção de novos, modificar existentes ou remover EA em uma única chamada.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Windows
cabeçalho	ntifs.h

Consulte também

FsRtlQueryKernelEaFile

ZwQueryEaFile

ZwSetEaFile

Compartilhar via