Funzione FltQueryEaFile (fltkernel.h)

  • Articolo

FltQueryEaFile restituisce informazioni sui valori di attributo esteso (EA) 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 dell'istanza opaca per l'istanza del driver minifilter a cui deve essere inviata l'operazione QueryEa . L'istanza deve essere collegata al volume in cui si trova il file.

[in] FileObject

Puntatore a oggetti file per il file.

[out] ReturnedEaData

Puntatore a un buffer di input strutturato FILE_FULL_EA_INFORMATION fornito dal chiamante in cui devono essere restituiti i valori dell'attributo esteso.

[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 buffer di input strutturato FILE_GET_EA_INFORMATION fornito dal chiamante che specifica gli attributi estesi su cui eseguire la 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 dell'elenco di 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 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 ha rilevato un errore di allocazione del pool. Si tratta di un codice di errore.

Requisiti

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

Vedi anche

FILE_FULL_EA_INFORMATION

FILE_GET_EA_INFORMATION

FltSetEaFile

IoCheckEaBufferValidity