FILE_FULL_DIR_INFO Struktur (winbase.h)

Enthält Verzeichnisinformationen für eine Datei. Diese Struktur wird von der GetFileInformationByHandleEx-Funktion zurückgegeben, wenn FileFullDirectoryInfo oder FileFullDirectoryRestartInfo im FileInformationClass-Parameter übergeben wird.

Syntax

typedef struct _FILE_FULL_DIR_INFO {
  ULONG         NextEntryOffset;
  ULONG         FileIndex;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER EndOfFile;
  LARGE_INTEGER AllocationSize;
  ULONG         FileAttributes;
  ULONG         FileNameLength;
  ULONG         EaSize;
  WCHAR         FileName[1];
} FILE_FULL_DIR_INFO, *PFILE_FULL_DIR_INFO;

Member

NextEntryOffset

Der Offset für die nächste FILE_FULL_DIR_INFO Struktur, die zurückgegeben wird. Enthält null (0), wenn keine anderen Einträge folgen.

FileIndex

Der Byteoffset der Datei im übergeordneten Verzeichnis. Dieser Member ist für Dateisysteme wie NTFS nicht definiert, in denen die Position einer Datei im übergeordneten Verzeichnis nicht festgelegt ist und jederzeit geändert werden kann, um die Sortierreihenfolge beizubehalten.

CreationTime

Der Zeitpunkt, zu dem die Datei erstellt wurde.

LastAccessTime

Der Zeitpunkt, zu dem zuletzt auf die Datei zugegriffen wurde.

LastWriteTime

Der Zeitpunkt, in den die Datei zuletzt geschrieben wurde.

ChangeTime

Der Zeitpunkt, zu dem die Datei zuletzt geändert wurde.

EndOfFile

Die absolute neue End-of-File-Position als Byteoffset vom Anfang der Datei bis zum Ende des Standarddatenstroms der Datei. 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, das unmittelbar auf das letzte gültige Byte in der Datei folgt.

AllocationSize

Die Anzahl der Bytes, die für die Datei zugewiesen werden. Dieser Wert ist in der Regel ein Vielfaches der Sektor- oder Clustergröße des zugrunde liegenden physischen Geräts.

FileAttributes

Die Dateiattribute. Dieser Member kann eine beliebige gültige Kombination der folgenden Attribute sein:

FILE_ATTRIBUTE_ARCHIVE (0x00000020)

FILE_ATTRIBUTE_COMPRESSED (0x00000800)

FILE_ATTRIBUTE_DIRECTORY (0x00000010)

FILE_ATTRIBUTE_HIDDEN (0x00000002)

FILE_ATTRIBUTE_NORMAL (0x00000080)

FILE_ATTRIBUTE_READONLY (0x00000001)

FILE_ATTRIBUTE_SYSTEM (0x00000004)

FILE_ATTRIBUTE_TEMPORARY (0x00000100)

FileNameLength

Die Länge des Dateinamens.

EaSize

Die Größe der erweiterten Attribute für die Datei.

FileName[1]

Das erste Zeichen der Dateinamenzeichenfolge. Dies wird im Arbeitsspeicher durch den Rest der Zeichenfolge gefolgt.

Hinweise

Die FILE_FULL_DIR_INFO-Struktur ist eine Teilmenge der Informationen in der FILE_ID_BOTH_DIR_INFO-Struktur . Wenn die zusätzlichen Informationen nicht benötigt werden, ist der Vorgang schneller, da er aus dem Verzeichniseintrag stammt. FILE_ID_BOTH_DIR_INFO enthält Informationen sowohl aus dem Verzeichniseintrag als auch aus der Master file Table (MFT).

Zum Abfragen dieser Informationen sind keine spezifischen Zugriffsrechte erforderlich.

Alle Datums- und Uhrzeitangaben sind im absoluten Systemzeitformat. Die absolute Systemzeit ist die Anzahl der Intervalle von 100 Nanosekunden seit Jahresbeginn 1601.

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

Um eine Anwendung zu kompilieren, die diese Struktur verwendet, definieren Sie das _WIN32_WINNT Makro als 0x0600 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	winbase.h (einschließlich Windows.h)

Weitere Informationen

FILE_INFO_BY_HANDLE_CLASS

Strukturen in der Dateiverwaltung

GetFileInformationByHandleEx