Função FltQueryEaFile (fltkernel.h)

  • Artigo

FltQueryEaFile retorna informações sobre valores de EA (atributo estendido) para um arquivo.

Sintaxe

NTSTATUS FLTAPI FltQueryEaFile(
  [in]            PFLT_INSTANCE Instance,
  [in]            PFILE_OBJECT  FileObject,
  [out]           PVOID         ReturnedEaData,
  [in]            ULONG         Length,
  [in]            BOOLEAN       ReturnSingleEntry,
  [in, optional]  PVOID         EaList,
  [in]            ULONG         EaListLength,
  [in, optional]  PULONG        EaIndex,
  [in]            BOOLEAN       RestartScan,
  [out, optional] PULONG        LengthReturned
);

Parâmetros

[in] Instance

Ponteiro de instância opaco para a instância de driver de minifiltro para a qual a operação QueryEa deve ser enviada. A instância deve ser anexada ao volume em que o arquivo reside.

[in] FileObject

Ponteiro de objeto de arquivo para o arquivo.

[out] ReturnedEaData

Ponteiro para um buffer de entrada FILE_FULL_EA_INFORMATION estruturado pelo chamador em que os valores de atributo estendido devem ser retornados.

[in] Length

Comprimento, em bytes, do buffer para o qual o parâmetro ReturnedEaData aponta.

[in] ReturnSingleEntry

Defina como TRUE se FltQueryEaFile deve retornar apenas a primeira entrada encontrada.

[in, optional] EaList

Ponteiro para um buffer de entrada estruturado FILE_GET_EA_INFORMATION fornecido pelo chamador especificando os atributos estendidos a serem consultados. Esse parâmetro é opcional e pode ser NULL.

[in] EaListLength

Comprimento, em bytes, do buffer para o qual o parâmetro EaList aponta.

[in, optional] EaIndex

Índice da entrada na qual iniciar a verificação da lista de atributos estendidos do arquivo. Esse parâmetro será ignorado se o parâmetro EaList apontar para uma lista não vazia. Esse parâmetro é opcional e pode ser NULL.

[in] RestartScan

Defina como TRUE se FltQueryEaFile deve iniciar a verificação na primeira entrada na lista de atributos estendidos do arquivo. Se esse parâmetro não estiver definido como TRUE, a verificação será retomada de uma chamada anterior para FltQueryEaFile.

[out, optional] LengthReturned

Ponteiro para uma variável alocada pelo chamador que recebe o tamanho, em bytes, das informações retornadas no buffer ReturnedEaData . Esse parâmetro é opcional e pode ser NULL.

Retornar valor

FltQueryEaFile retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno Descrição
STATUS_EAS_NOT_SUPPORTED
 O sistema de arquivos não dá suporte a atributos estendidos. Este é um código de erro.
STATUS_FLT_DELETING_OBJECT
 A instância ou o volume está sendo derrubado. Este é um código de erro.
STATUS_INSUFFICIENT_RESOURCES
 FltQueryEaFile encontrou uma falha de alocação de pool. Este é um código de erro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Pacote Cumulativo de Atualizações 1 do Microsoft Windows 2000 para SP4, Windows XP SP3, Windows Server 2003 SP1 e versões posteriores do sistema operacional Windows.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Confira também

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity