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 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. 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à le 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 |
|---|---|
| intestazione |
fltkernel.h |