FILE_ID_FULL_DIR_INFORMATION-Struktur (ntifs.h)
Die FILE_ID_FULL_DIR_INFORMATION-Struktur wird verwendet, um detaillierte Informationen für die Dateien in einem Verzeichnis abzufragen.
Syntax
typedef struct _FILE_ID_FULL_DIR_INFORMATION {
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;
LARGE_INTEGER FileId;
WCHAR FileName[1];
} FILE_ID_FULL_DIR_INFORMATION, *PFILE_ID_FULL_DIR_INFORMATION;
Member
NextEntryOffset
Byteoffset des nächsten FILE_ID_FULL_DIR_INFORMATION Eintrags, wenn mehrere Einträge in einem Puffer vorhanden sind. Dieser Member ist 0, wenn keine anderen Einträge folgen.
FileIndex
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
Zeitpunkt, zu dem die Datei erstellt wurde.
LastAccessTime
Zuletzt wurde auf die Datei zugegriffen.
LastWriteTime
Zuletzt wurden Informationen in die Datei geschrieben.
ChangeTime
Das letzte Mal wurde die Datei geändert.
EndOfFile
Absolute neue End-of-File-Position als Byteoffset vom Anfang der Datei. EndOfFile gibt den Byteoffset 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.
AllocationSize
Dateizuordnungsgröße in Bytes. In der Regel ist dieser Wert ein Vielfaches der Sektor- oder Clustergröße des zugrunde liegenden physischen Geräts.
FileAttributes
Dateiattribute, die eine beliebige gültige Kombination der folgenden sein können:
- FILE_ATTRIBUTE_READONLY
- FILE_ATTRIBUTE_HIDDEN
- FILE_ATTRIBUTE_SYSTEM
- FILE_ATTRIBUTE_DIRECTORY
- FILE_ATTRIBUTE_ARCHIVE
- FILE_ATTRIBUTE_NORMAL
- FILE_ATTRIBUTE_TEMPORARY
- FILE_ATTRIBUTE_COMPRESSED
FileNameLength
Gibt die Länge der Dateinamenzeichenfolge an.
EaSize
Kombinierte Länge (in Bytes) der erweiterten Attribute (EA) für die Datei.
FileId
Die 8-Byte-Dateireferenznummer für die Datei. (Beachten Sie, dass dies nicht mit der 16-Byte-Dateiobjekt-ID identisch ist, die NTFS für Microsoft Windows 2000 hinzugefügt wurde.)
FileName[1]
Gibt das erste Zeichen der Dateinamenzeichenfolge an. Dies wird im Arbeitsspeicher durch den Rest der Zeichenfolge gefolgt.
Hinweise
Diese Informationen können auf eine der folgenden Arten abgefragt werden:
Rufen Sie ZwQueryDirectoryFile auf, übergeben Sie FileIdFullDirectoryInformation als Wert von FileInformationClass , und übergeben Sie einen aufruferseitig zugeordneten, FILE_ID_FULL_DIR_INFORMATION strukturierten Puffer als Wert von FileInformation.
Erstellen Sie eine IRP mit Hauptfunktionscode IRP_MJ_DIRECTORY_CONTROL und Nebenfunktionscode IRP_MN_QUERY_DIRECTORY.
Zum Abfragen dieser Informationen sind keine spezifischen Zugriffsrechte erforderlich.
Dateiverweisnummern, auch Datei-IDs genannt, sind garantiert nur innerhalb eines statischen Dateisystems eindeutig. Es ist nicht garantiert, dass sie im Laufe der Zeit eindeutig sind, da Dateisysteme sie wiederverwenden können. Es ist auch nicht garantiert, dass sie konstant bleiben. Beispielsweise generiert das FAT-Dateisystem die Dateiverweisnummer für eine Datei aus dem Byteoffset des Verzeichniseintrags (DIRENT) der Datei auf dem Datenträger. Die Defragmentierung kann diesen Byteoffset ändern. Daher kann sich eine FAT-Dateireferenznummer im Laufe der Zeit ändern.
Alle Datums- und Uhrzeitangaben sind im absoluten Systemzeitformat. Die absolute Systemzeit ist die Anzahl der Intervalle von 100 Nanosekunden seit Jahresbeginn 1601.
Diese 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.
Anforderungen
Anforderung | Wert |
---|---|
Header | ntifs.h (include Ntifs.h, Fltkernel.h) |