Funzione FltRetrieveFileInfoOnCreateCompletion (fltkernel.h)

  • Articolo

FltRetrieveFileInfoOnCreateCompletion recupera le informazioni sul file richieste durante la creazione del file. Usare FltRetrieveFileInfoOnCreateCompletionEx per ottenere un codice NTSTATUS insieme alle informazioni richieste.

Sintassi

PVOID FLTAPI FltRetrieveFileInfoOnCreateCompletion(
  [in]  PFLT_FILTER        Filter,
  [in]  PFLT_CALLBACK_DATA Data,
  [in]  ULONG              InfoClass,
  [out] PULONG             Size
);

Parametri

[in] Filter

Puntatore di filtro opaco che identifica in modo univoco il driver minifilter.

[in] Data

Puntatore al FLT_CALLBACK_DATA dati di callback che rappresentano l'operazione di I/O.

[in] InfoClass

Flag che indica il tipo di informazioni da restituire. Si noti che i flag non possono essere combinati. I possibili valori sono i seguenti:

Contrassegno Significato
QoCFileStatInformation (0x00000001) Il file system restituirà le informazioni sullo stato del file in una struttura QUERY_ON_CREATE_FILE_STAT_INFORMATION.
QoCFileLxInformation (0x00000002) Il file system restituirà informazioni simili a Linux estese in una struttura di QUERY_ON_CREATE_FILE_LX_INFORMATION.
QoCFileEaInformation (0x00000004) Il file system restituirà gli attributi estesi (EA) in una struttura QUERY_ON_CREATE_EA_INFORMATION.

[out] Size

Puntatore a un ULONG che specifica le dimensioni, in byte, del buffer restituito da questa funzione.

Valore restituito

FltRetrieveFileInfoOnCreateCompletion restituisce un puntatore a un buffer con le informazioni sul file richieste. La struttura all'interno del buffer è determinata dal valore di InfoClass. Se il file system elabora la richiesta ma non riesce a trovare le informazioni sul file richieste, questo parametro è impostato su NULL.

Commenti

Un minifilter deve chiamare FltRequestFileInfoOnCreateCompletion durante la pre-creazione del file per specificare le informazioni sul file system da tenere traccia.

Requisiti

Requisito Valore
Intestazione fltkernel.h

Vedi anche

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx