FltRetrieveFileInfoOnCreateCompletion-Funktion (fltkernel.h)
FltRetrieveFileInfoOnCreateCompletion ruft die angeforderten Dateiinformationen während der Dateierstellung ab. Verwenden Sie FltRetrieveFileInfoOnCreateCompletionEx , um einen NTSTATUS-Code zusammen mit den angeforderten Informationen abzurufen.
Syntax
PVOID FLTAPI FltRetrieveFileInfoOnCreateCompletion(
[in] PFLT_FILTER Filter,
[in] PFLT_CALLBACK_DATA Data,
[in] ULONG InfoClass,
[out] PULONG Size
);
Parameter
[in] Filter
Undurchsichtiger Filterzeiger, der den Minifiltertreiber eindeutig identifiziert.
[in] Data
Zeiger auf die FLT_CALLBACK_DATA Rückrufdaten, die den E/A-Vorgang darstellen.
[in] InfoClass
Flag, das den Typ der zurückzugebenden Informationen angibt. Beachten Sie, dass Flags nicht kombiniert werden können. Folgenden Werte sind möglich:
| Flag | Bedeutung |
|---|---|
| QoCFileStatInformation (0x00000001) | Das Dateisystem gibt Dateistatinformationen in einer QUERY_ON_CREATE_FILE_STAT_INFORMATION-Struktur zurück. |
| QoCFileLxInformation (0x00000002) | Das Dateisystem gibt erweiterte Linux-ähnliche Informationen in einer QUERY_ON_CREATE_FILE_LX_INFORMATION-Struktur zurück. |
| QoCFileEaInformation (0x00000004) | Das Dateisystem gibt erweiterte Attribute (EA) in einer QUERY_ON_CREATE_EA_INFORMATION-Struktur zurück. |
| QoCFileUsnInformation (0x00000008) | Das Dateisystem gibt USN-Informationen in einer QUERY_ON_CREATE_USN_INFORMATION-Struktur zurück. |
| QoCFileSecurityInformation (0x00000010) | Das Dateisystem gibt Dateisicherheitsinformationen in einer QUERY_ON_CREATE_SECURITY_INFORMATION-Struktur zurück. |
[out] Size
Zeiger auf eine ULONG, die die Größe des Puffers in Bytes angibt, den diese Funktion zurückgibt.
Rückgabewert
FltRetrieveFileInfoOnCreateCompletion gibt einen Zeiger auf einen Puffer mit den angeforderten Dateiinformationen zurück. Die Struktur innerhalb des Puffers wird durch den Wert von InfoClass bestimmt. Wenn das Dateisystem die Anforderung verarbeitet, aber die angeforderten Dateiinformationen nicht finden kann, wird dieser Parameter auf NULL festgelegt.
Hinweise
Ein Minifilter muss FltRequestFileInfoOnCreateCompletion während der Dateivorerstellung aufrufen, um anzugeben, welche Dateiinformationen das Dateisystem nachverfolgen soll.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | fltkernel.h |