MmCanFileBeTruncated-Funktion (ntifs.h)

Artikel
03/29/2024

Die MmCanFileBeTruncated-Routine überprüft, ob eine Datei abgeschnitten werden kann.

Syntax

BOOLEAN MmCanFileBeTruncated(
  [in]           PSECTION_OBJECT_POINTERS SectionPointer,
  [in, optional] PLARGE_INTEGER           NewFileSize
);

Parameter

[in] SectionPointer

Zeiger auf eine Struktur, die die Abschnittsobjektzeiger des Dateiobjekts enthält.

[in, optional] NewFileSize

Zeiger auf eine Variable, die die Größe in Bytes angibt, auf die die Datei abgeschnitten werden soll. Wenn dieser Parameter NULL ist, wird eine Länge von 0 (null) angenommen, und MmCanFileBeTruncated überprüft, ob die gesamte Datei abgeschnitten werden kann.

Rückgabewert

MmCanFileBeTruncated gibt TRUE zurück, wenn die Datei abgeschnitten werden kann. Andernfalls FALSE.

Hinweise

MmCanFileBeTruncated muss immer aufgerufen werden, bevor eine Datei abgeschnitten wird.

Eine Datei kann nicht abgeschnitten werden (und MmCanFileBeTruncated gibt FALSE zurück), wenn eine der folgenden Werte zutrifft:

Für die Datei ist ein Bildabschnitt vorhanden.
Es gibt einen oder mehrere ausstehende Schreibtests im Datenabschnitt der Datei.
Es gibt eine zugeordnete Ansicht des Datenabschnitts der Datei innerhalb des durch NewFileSize festgelegten Abschneidungsbereichs.
Mindestens ein Benutzer enthält Verweise auf den Datenabschnitt für die Datei und NewFileSize<= die aktuelle Dateigröße.