FltRetrieveFileInfoOnCreateCompletion-Funktion (fltkernel.h)

Artikel
12/21/2024

FltRetrieveFileInfoOnCreateCompletion die angeforderten Dateiinformationen während der Dateierstellung abruft. 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

Zeigen Sie 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. Dies kann einer der folgenden Werte sein:

Flagge	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 von dieser Funktion zurückgegebenen Puffers in Byte angibt.

Rückgabewert

FltRetrieveFileInfoOnCreateCompletion gibt einen Zeiger auf einen Puffer mit den angeforderten Dateiinformationen zurück. Die Struktur innerhalb des Puffers wird durch den Wert InfoClassbestimmt. Wenn das Dateisystem die Anforderung verarbeitet, aber die angeforderten Dateiinformationen nicht finden kann, wird dieser Parameter auf NULL festgelegt.

Bemerkungen

Ein Minifilter muss FltRequestFileInfoOnCreateCompletion- während der Dateivorerstellung aufrufen, um anzugeben, welche Dateiinformationen das Dateisystem nachverfolgen soll.

Anforderungen

Anforderung	Wert
Header-	fltkernel.h

Siehe auch

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx

Freigeben über