Função FsRtlSetKernelEaFile (ntifs.h)
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 |
|---|---|
|
O parâmetro EaList não está formatado corretamente. |
|
O sistema de arquivos não dá suporte a atributos estendidos. |
|
O IRP (pacote de solicitação de E/S) não pôde ser alocado para essa solicitação. |
|
A solicitação não pode intermixar EAs normais e kernel na mesma chamada. |
|
A solicitação falhou porque era um dispositivo direto aberto. |
|
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 |