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) |