Funzione FltRetrieveFileInfoOnCreateCompletion (fltkernel.h)

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 minifiltro.

[in] Data

Puntatore ai dati di callback FLT_CALLBACK_DATA 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. Può essere uno dei valori seguenti:

Bandiera Significato
QoCFileStatInformation (0x00000001) Il file system restituirà informazioni sullo stato dei file in una struttura QUERY_ON_CREATE_FILE_STAT_INFORMATION .
QoCFileLxInformation (0x00000002) Il file system restituirà informazioni simili a Linux estese in una struttura QUERY_ON_CREATE_FILE_LX_INFORMATION .
QoCFileEaInformation (0x00000004) Il file system restituirà gli attributi estesi (EA) in una struttura QUERY_ON_CREATE_EA_INFORMATION .
QoCFileUsnInformation (0x00000008) Il file system restituirà informazioni USN in una struttura QUERY_ON_CREATE_USN_INFORMATION .
QoCFileSecurityInformation (0x00000010) Il file system restituirà le informazioni di sicurezza dei file in una struttura QUERY_ON_CREATE_SECURITY_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.

Osservazioni

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

Fabbisogno

Requisito Valore
Client minimo supportato Windows 10, versione 1809
intestazione fltkernel.h

Vedere anche

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx