FILE_STAT_BASIC_INFORMATION Struktur (ntifs.h)

FILE_STAT_BASIC_INFORMATION enthält grundlegende Metadaten zu einer Datei.

Syntax

typedef struct _FILE_STAT_BASIC_INFORMATION {
  LARGE_INTEGER FileId;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER AllocationSize;
  LARGE_INTEGER EndOfFile;
  ULONG         FileAttributes;
  ULONG         ReparseTag;
  ULONG         NumberOfLinks;
  ULONG         DeviceType;
  ULONG         DeviceCharacteristics;
  ULONG         Reserved;
  LARGE_INTEGER VolumeSerialNumber;
  FILE_ID_128   FileId128;
} FILE_STAT_BASIC_INFORMATION, *PFILE_STAT_BASIC_INFORMATION;

Angehörige

FileId

Gibt den Bezeichner einer Datei an.

CreationTime

Gibt die Erstellungszeit einer Datei an.

LastAccessTime

Gibt an, wie lange auf eine Datei zuletzt zugegriffen wurde.

LastWriteTime

Gibt an, wie lange eine Datei zuletzt geschrieben wurde.

ChangeTime

Gibt an, wie lange eine Datei zuletzt geändert wurde.

AllocationSize

Dateizuordnungsgröße in Byte. Normalerweise ist dieser Wert ein Vielfaches des Sektors oder der Clustergröße des zugrunde liegenden physischen Geräts.

EndOfFile

Die absolute neue End-of-File-Position als Byte-Offset vom Anfang der Datei. EndOfFile- gibt den Byteoffset bis zum Ende der Datei an. Da dieser Wert nullbasiert ist, bezieht er sich tatsächlich auf das erste freie Byte in der Datei. Mit anderen Worten, EndOfFile- ist der Offset auf das Byte unmittelbar nach dem letzten gültigen Byte in der Datei.

FileAttributes

Dateiattribute, die eine beliebige gültige Kombination aus folgendem Sein können:

ReparseTag

Gibt das Tag für einen Analysepunkt an. Weitere Informationen finden Sie unter Informationen zu Analysepunkten.

NumberOfLinks

Gibt die Anzahl der Verknüpfungen zur Datei an.

DeviceType

Wird festgelegt, wenn ein Treiber IoCreateDevice für den Typ des zugrunde liegenden Geräts aufruft. Weitere Informationen finden Sie unter Angeben von Gerätetypen.

DeviceCharacteristics

Die Gerätemerkmale. Eine Beschreibung der relevanten Werte finden Sie unter DEVICE_OBJECT.

Reserved

Reserviert für die Systemverwendung.

VolumeSerialNumber

Seriennummer des Volumes, auf dem sich die Datei befindet.

FileId128

Die 128-Byte-Dateireferenznummer für die Datei. Diese Nummer wird generiert und der Datei vom Dateisystem zugewiesen.

Bemerkungen

Diese Informationen können auf eine der folgenden Arten abgefragt werden:

• Rufen Sie ZwQueryDirectoryFileauf, und übergeben Sie FileStatBasicInformation als Wert von FileInformationClass und übergeben Sie einen zugeordneten Aufrufer, FILE_ID_EXTD_DIR_INFORMATION-strukturierten Puffer als Wert von FileInformation.

• Erstellen Sie ein IRP mit Hauptfunktionscode IRP_MJ_DIRECTORY_CONTROL und Nebenfunktionscode IRP_MN_QUERY_DIRECTORY.

Zum Abfragen dieser Informationen sind keine spezifischen Zugriffsrechte erforderlich.

Dateireferenznummern, auch als Datei-IDs bezeichnet, sind garantiert nur innerhalb eines statischen Dateisystems eindeutig. Sie sind nicht garantiert im Laufe der Zeit einzigartig, da Dateisysteme sie wiederverwenden können. Sie werden auch nicht garantiert konstant bleiben. Beispielsweise generiert das FAT-Dateisystem die Dateireferenznummer für eine Datei aus dem Byte-Offset des Verzeichniseintragseintrags der Datei (DIRENT) auf dem Datenträger. Defragmentierung kann diesen Byte-Offset ändern. Eine FAT-Dateiverweisnummer kann sich daher im Laufe der Zeit ändern.

Alle Datums- und Uhrzeitangaben befinden sich im absoluten Systemzeitformat. Absolute Systemzeit ist die Anzahl von 100-Nanosekunden-Intervallen seit Beginn des Jahres 1601.

Diese Struktur muss an einer LONGLONG-Grenze (8-Byte) ausgerichtet werden. Wenn ein Puffer zwei oder mehr dieser Strukturen enthält, fällt der NextEntryOffset Wert in jedem Eintrag, mit Ausnahme der letzten, auf eine Grenze von 8 Byte.

Anforderungen

Siehe auch

FILE_INFORMATION_CLASS

ZwQueryInformationByName