FltRetrieveFileInfoOnCreateCompletion-Funktion (fltkernel.h)

  • Artikel

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.

[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

Weitere Informationen

FLT_CALLBACK_DATA

FltRequestFileInfoOnCreateCompletion

FltRetrieveFileInfoOnCreateCompletionEx