MmCanFileBeTruncated-Funktion (ntifs.h)

Artikel
12/22/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

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

[in, optional] NewFileSize

Zeigen Sie auf eine Variable, die die Größe in Byte angibt, an die die Datei abgeschnitten werden soll. Wenn dieser Parameter NULL ist, wird eine Länge von 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.

Bemerkungen

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

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

Für die Datei ist ein Bildabschnitt vorhanden.
Im Datenabschnitt der Datei gibt es einen oder mehrere ausstehende Schreibsonden.
Es gibt eine zugeordnete Ansicht des Datenabschnitts der Datei innerhalb des abgeschnittenen Bereichs, der durch NewFileSizebestimmt wird.
Mindestens ein Benutzer enthält Verweise auf den Datenabschnitt für die Datei, und NewFileSize<= die aktuelle Dateigröße.