FltGetCopyInformationFromCallbackData-Funktion (fltkernel.h)

Artikel
02/29/2024

Die FltGetCopyInformationFromCallbackData-Routine ruft Kopierinformationen aus den Rückrufdaten ab, sofern vorhanden. Die Kopierinformationen befinden sich in der IRP-Erweiterung für Lese-/Schreibaufrufe, die von NtCopyFileChunk stammen.

Syntax

NTSTATUS FLTAPI FltGetCopyInformationFromCallbackData(
  [in]  PFLT_CALLBACK_DATA Data,
  [out] PCOPY_INFORMATION  CopyInformation
);

Parameter

[in] Data

Zeiger auf eine FLT_CALLBACK_DATA Struktur, die die Rückrufdaten enthält.

[out] CopyInformation

Zeiger auf eine COPY_INFORMATION-Struktur , in die die Kopierinformationen geschrieben werden.

Rückgabewert

FltGetCopyInformationFromCallbackData gibt bei Erfolg STATUS_SUCCESS oder einen Fehlercode wie den folgenden zurück.

Fehlercode	Bedeutung
STATUS_INVALID_PARAMETER	Die Rückrufdaten sind nicht für einen IRP-Vorgang vorgesehen.
STATUS_NOT_FOUND	Die IRP-Erweiterung für Kopierinformationen wurde für das IRP nicht festgelegt.

Hinweise

Alle vertrauenswürdigen Lese- oder Schreibvorgänge aus NtCopyFileChunk haben Folgendes:

Der Anforderermodus des IRP ist auf KernelMode festgelegt.
Eine IRP-Erweiterung mit einem IopCopyInformationType-Typ und Informationen zum Kopiervorgang.

Filter haben keinen direkten Zugriff auf IRP-Erweiterungen, können aber überprüfen, ob die Kopiererweiterung vorhanden ist, und Kopierinformationen abrufen, indem Sie FltGetCopyInformationFromCallbackData aufrufen.

Weitere Informationen finden Sie unter Kopieren von Dateien im Kernelmodus und Erkennen von Kopierdateiszenarien .