Freigeben über


FltGetCopyInformationFromCallbackData-Funktion (fltkernel.h)

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 .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 22H2
Kopfzeile fltkernel.h
IRQL <= DISPATCH_LEVEL

Weitere Informationen

COPY_INFORMATION

IoCheckFileObjectOpenedAsCopyDestination

IoCheckFileObjectOpenedAsCopySource

NtCopyFileChunk

NtCreateFile