FILE_VALID_DATA_LENGTH_INFORMATION Struktur (ntddk.h)

Artikel
02/07/2025

Die FILE_VALID_DATA_LENGTH_INFORMATION Struktur wird als Argument zum ZwSetInformationFile-verwendet.

Syntax

typedef struct _FILE_VALID_DATA_LENGTH_INFORMATION {
  LARGE_INTEGER ValidDataLength;
} FILE_VALID_DATA_LENGTH_INFORMATION, *PFILE_VALID_DATA_LENGTH_INFORMATION;

Angehörige

ValidDataLength

Gibt die neue gültige Datenlänge für die Datei an. Dieser Parameter muss ein positiver Wert sein, der größer als die aktuelle gültige Datenlänge ist, jedoch kleiner oder gleich der aktuellen Dateigröße.

Bemerkungen

Die FILE_VALID_DATA_LENGTH_INFORMATION Struktur wird verwendet, um eine neue gültige Datenlänge für eine Datei auf einem NTFS-Volume festzulegen. Die gültigen Datenlänge einer Datei ist die Länge der Daten, die in Bytes in die Datei geschrieben wurden. Diese gültigen Daten vom Anfang der Datei bis zum letzten Byte in der Datei erweitert, das nicht null oder nicht initialisiert wurde.

Das Festlegen dieser Informationen erfordert FILE_WRITE_DATA Zugriff auf die Datei. Darüber hinaus müssen Nichtadministratoren und Remotebenutzer SeManageVolumePrivilege (SE_MANAGE_VOLUME_PRIVILEGE) für das Volume verfügen, auf dem sich die Datei befindet.

Dateisystemfiltertreiber können es hilfreich finden, eine gültige Datenlänge in den folgenden Szenarien festzulegen:

Wenn Sie unformatierte Cluster direkt über einen Hardwarekanal auf den Datenträger schreiben. Dadurch kann der Filtertreiber das Dateisystem darüber informieren, dass dieser Bereich gültige Daten enthält, die an den Benutzer zurückgegeben werden können.
Beim Erstellen großer Dateien, bei denen die Leistung ein Problem ist. Dadurch wird die Zeit vermieden, die zum Ausfüllen der Datei mit Nullen benötigt wird, wenn die Datei erstellt oder erweitert wird.
Wenn Sie eine Datei remote erweitern und auf den Datenträger in einem Clusterdateisystem mit bereitgestellten Metadaten schreiben.

Die Größe des FileInformation An ZwSetInformation File übergebenen Puffers muss mindestens Größe(FILE_VALID_DATA_LENGTH_INFORMATION) sein.

Diese Struktur muss an einer LONGLONG-Grenze (8-Byte) ausgerichtet werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar unter Microsoft Windows XP und höheren Versionen des Windows-Betriebssystems.
Header-	ntddk.h (include Ntddk.h)

Siehe auch

ZwSetInformationFile-

Freigeben über