FILE_BASIC_INFORMATION Struktur (wdm.h)

Artikel
02/07/2025

Die FILE_BASIC_INFORMATION-Struktur enthält Zeitstempel und grundlegende Attribute einer Datei. Sie wird als Argument für Routinen verwendet, die Dateiinformationen abfragen oder festlegen.

Syntax

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

Angehörige

CreationTime

Gibt den Zeitpunkt an, zu dem die Datei erstellt wurde.

LastAccessTime

Gibt die Uhrzeit an, zu der die Datei zuletzt zugegriffen wurde.

LastWriteTime

Gibt die Uhrzeit an, zu der die Datei zuletzt geschrieben wurde.

ChangeTime

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

FileAttributes

Gibt ein oder mehrere FILE_ATTRIBUTE_XXX- Flags an. Beschreibungen dieser Flags finden Sie unter Dateiattributekonstanten im Microsoft Windows SDK.

Bemerkungen

Das FILE_ATTRIBUTE_NORMAL Flag kann nicht in Kombination mit anderen Attributen festgelegt oder zurückgegeben werden. Alle anderen FileAttributes Werte überschreiben dieses Attribut.

Zeitwerte CreationTime, LastAccessTime, LastWriteTime-und ChangeTime- werden im absoluten Systemzeitformat ausgedrückt. Absolute Systemzeit ist die Anzahl von 100-Nanosekunden-Intervallen seit Beginn des Jahres 1601 im gregorianischen Kalender.

Wenn Sie einen Wert von Null für einen der XxxTime Member der FILE_BASIC_INFORMATION Struktur angeben, behält die ZwSetInformationFile--Funktion die aktuelle Einstellung einer Datei für diese Zeit bei.

Das Dateisystem aktualisiert die Werte der LastAccessTime-, LastWriteTime-und ChangeTime- Elemente entsprechend, nachdem ein E/A-Vorgang für eine Datei ausgeführt wurde. Ein Treiber oder eine Anwendung kann anfordern, dass das Dateisystem mindestens einen dieser Member für E/A-Vorgänge nicht aktualisiert, die für das Dateihandle des Aufrufers ausgeführt werden, indem die entsprechenden Member auf -1 festgelegt werden. Der Aufrufer kann eine, alle oder eine andere Kombination dieser drei Member auf -1 festlegen. Nur die Mitglieder, die auf -1 festgelegt sind, sind von E/A-Vorgängen für das Dateihandle nicht betroffen; die anderen Mitglieder werden entsprechend aktualisiert. Auf NTFS- und ReFS-Systemen können Zeitstempelaktualisierungen für das Dateihandle wiederhergestellt werden, indem die entsprechenden Member auf -2 festgelegt werden.

Um die Member dieser Struktur festzulegen, muss der Aufrufer über FILE_WRITE_ATTRIBUTES Zugriff auf die Datei verfügen.