FILE_BASIC_INFORMATION-Struktur (wdm.h)

Artikel
03/05/2024

Die FILE_BASIC_INFORMATION-Struktur enthält Zeitstempel und grundlegende Attribute einer Datei. Es 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;

Member

CreationTime

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

LastAccessTime

Gibt den Zeitpunkt an, zu dem zuletzt auf die Datei zugegriffen wurde.

LastWriteTime

Gibt den Zeitpunkt an, zu dem die Datei zuletzt geschrieben wurde.

ChangeTime

Gibt den Zeitpunkt an, zu dem die Datei zuletzt geändert wurde.

FileAttributes

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

Hinweise

Das FILE_ATTRIBUTE_NORMAL-Flag kann nicht in Kombination mit anderen Attributen festgelegt oder zurückgegeben werden. Alle anderen FileAttributes-Werte setzen dieses Attribut außer Kraft.

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

Wenn Sie für einen der XxxTime-Member der FILE_BASIC_INFORMATION-Struktur den Wert null angeben, behält die ZwSetInformationFile-Funktion die aktuelle Einstellung einer Datei für diesen Zeitpunkt bei.

Das Dateisystem aktualisiert die Werte der Member LastAccessTime, LastWriteTime und ChangeTime nach Bedarf, nachdem ein E/A-Vorgang für eine Datei ausgeführt wurde. Ein Treiber oder eine Anwendung kann anfordern, dass das Dateisystem eines oder mehrere dieser Member nicht für E/A-Vorgänge aktualisiert, die für das Dateihandle des Aufrufers ausgeführt werden, indem die entsprechenden Member auf -1 festgelegt werden. Der Aufrufer kann einen, alle oder eine beliebige andere Kombination dieser drei Member auf -1 festlegen. Nur die Member, die auf -1 festgelegt sind, sind von E/A-Vorgängen im Dateihandle nicht betroffen. die anderen Mitglieder werden entsprechend aktualisiert. Auf NTFS- und ReFS-Systemen können Zeitstempelupdates 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.