Funzione FltQueryEaFile (fltkernel.h)

Articolo
02/06/2025

FltQueryEaFile restituisce informazioni sui valori EA (Extended Attribute) per un file.

Sintassi

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
);

Parametri

[in] Instance

Puntatore a istanze opache per l'istanza del driver minifilter a cui deve essere inviata l'operazione di QueryEa. L'istanza deve essere collegata al volume in cui risiede il file.

[in] FileObject

Puntatore all'oggetto file per il file.

[out] ReturnedEaData

Puntatore a un chiamante fornito FILE_FULL_EA_INFORMATIONbuffer di input strutturato in cui devono essere restituiti i valori degli attributi estesi.

[in] Length

Lunghezza, in byte, del buffer a cui punta il parametro ReturnedEaData.

[in] ReturnSingleEntry

Impostare su TRUE se FltQueryEaFile deve restituire solo la prima voce trovata.

[in, optional] EaList

Puntatore a un chiamante fornito FILE_GET_EA_INFORMATIONbuffer di input strutturato che specifica gli attributi estesi su cui eseguire query. Questo parametro è facoltativo e può essere NULL.

[in] EaListLength

Lunghezza, in byte, del buffer a cui punta il parametro EaList.

[in, optional] EaIndex

Indice della voce in corrispondenza della quale iniziare l'analisi dell'elenco di attributi estesi del file. Questo parametro viene ignorato se il parametro EaList punta a un elenco non vuoto. Questo parametro è facoltativo e può essere NULL.

[in] RestartScan

Impostare su TRUE se FltQueryEaFile deve iniziare l'analisi alla prima voce nell'elenco degli attributi estesi del file. Se questo parametro non è impostato su TRUE, l'analisi viene ripresa da una chiamata precedente a FltQueryEaFile.

[out, optional] LengthReturned

Puntatore a una variabile allocata dal chiamante che riceve le dimensioni, in byte, delle informazioni restituite nel buffer restituito ReturnedEaData. Questo parametro è facoltativo e può essere NULL.

Valore restituito

FltQueryEaFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio:

Codice restituito	Descrizione
STATUS_EAS_NOT_SUPPORTED	Il file system non supporta gli attributi estesi. Si tratta di un codice di errore.
STATUS_FLT_DELETING_OBJECT	L'istanza o il volume viene eliminato. Si tratta di un codice di errore.
STATUS_INSUFFICIENT_RESOURCES	FltQueryEaFile rilevato un errore di allocazione del pool. Si tratta di un codice di errore.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows 2000 Update Rollup 1 per SP4, Windows XP SP3, Windows Server 2003 SP1 e versioni successive del sistema operativo Windows.
piattaforma di destinazione	Universale
intestazione	fltkernel.h (include Fltkernel.h)
libreria	FltMgr.lib
dll	Fltmgr.sys
IRQL	PASSIVE_LEVEL

Vedere anche

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity

Condividi tramite