FILE_ID_EXTD_DIR_INFO-Struktur (winbase.h)

Enthält Identifikationsinformationen für eine Datei. Diese Struktur wird von der GetFileInformationByHandleEx-Funktion zurückgegeben, wenn FileIdExtdDirectoryInfo (0x13) oder FileIdExtdDirectoryRestartInfo (0x14) im FileInformationClass-Parameter übergeben wird.

Syntax

typedef struct _FILE_ID_EXTD_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;
  ULONG         ReparsePointTag;
  FILE_ID_128   FileId;
  WCHAR         FileName[1];
} FILE_ID_EXTD_DIR_INFO, *PFILE_ID_EXTD_DIR_INFO;

Member

NextEntryOffset

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

FileIndex

Der Byteoffset der Datei im übergeordneten Verzeichnis. Dieser Member ist für Dateisysteme wie NTFS nicht definiert, bei 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, zu dem 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 der Datei. Da dieser Wert nullbasiert ist, bezieht er sich tatsächlich auf das erste freie Byte in der Datei. Anders ausgedrückt: EndOfFile ist der Offset zu dem Byte, das unmittelbar auf das letzte gültige Byte in der Datei folgt.

AllocationSize

Die Anzahl der Bytes, die der Datei zugeordnet sind. 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:

Wert Bedeutung
FILE_ATTRIBUTE_ARCHIVE
32 (0x20)
Eine Datei oder ein Verzeichnis, bei dem es sich um eine Archivdatei oder ein Verzeichnis handelt. Anwendungen verwenden üblicherweise dieses Attribut, um Dateien für die Sicherung oder Entfernung zu markieren. 
FILE_ATTRIBUTE_COMPRESSED
2048 (0x800)
Eine komprimierte Datei oder ein komprimiertes Verzeichnis. Bei einer Datei werden alle Daten in der Datei komprimiert. Bei einem Verzeichnis sind neu erstellte Dateien und Unterverzeichnisse standardmäßig komprimiert.
FILE_ATTRIBUTE_DEVICE
64 (0x40)
Dieser Wert ist für die Verwendung durch das System reserviert.
FILE_ATTRIBUTE_DIRECTORY
16 (0x10)
Das Handle, das ein Verzeichnis identifiziert.
FILE_ATTRIBUTE_ENCRYPTED
16384 (0x4000)
Eine verschlüsselte Datei oder ein verschlüsseltes Verzeichnis. Bei einer Datei sind alle Datenströme in der Datei verschlüsselt. Bei einem Verzeichnis sind neu erstellte Dateien und Unterverzeichnisse standardmäßig verschlüsselt.
FILE_ATTRIBUTE_HIDDEN
2 (0x2)
Die Datei oder das Verzeichnis ist versteckt. Die Datei ist ausgeblendet und daher nicht in einer normalen Verzeichnisliste enthalten.
FILE_ATTRIBUTE_NORMAL
128 (0x80)
Eine Datei, für die keine anderen Attribute festgelegt sind. Dieses Attribut ist nur gültig, wenn es allein verwendet wird.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
8192 (0x2000)
Die Datei oder das Verzeichnis darf nicht vom Inhaltsindizierungsdienst indiziert werden.
FILE_ATTRIBUTE_OFFLINE
4096 (0x1000)
Die Daten einer Datei sind nicht sofort verfügbar. Dieses Attribut gibt an, dass die Dateidaten physisch in den Offlinespeicher verschoben werden. Dieses Attribut wird von Remotespeicher verwendet, bei der es sich um die hierarchische Speicherverwaltungssoftware handelt. Anwendungen sollten dieses Attribut nicht willkürlich ändern.
FILE_ATTRIBUTE_READONLY
1 (0x1)
Eine Datei, die schreibgeschützt ist. Anwendungen können die Datei lesen, aber nicht in sie schreiben oder löschen. Dieses Attribut wird in Verzeichnissen nicht berücksichtigt. Weitere Informationen finden Sie unter Sie können die schreibgeschützten oder Systemattribute von Ordnern in Windows Server 2003, Windows XP, Windows Vista oder Windows 7 nicht anzeigen oder ändern.
FILE_ATTRIBUTE_REPARSE_POINT
1024 (0x400)
Eine Datei oder ein Verzeichnis mit einem zugeordneten Analysepunkt oder einer Datei, die eine symbolische Verknüpfung darstellt.
FILE_ATTRIBUTE_SPARSE_FILE
512 (0x200)
Die Datei ist eine Datei mit geringer Dichte.
FILE_ATTRIBUTE_SYSTEM
4 (0x4)
Eine Datei oder ein Verzeichnis, teilweise oder ausschließlich vom Betriebssystem verwendet.
FILE_ATTRIBUTE_TEMPORARY
256 (0x100)
Eine Datei, die für die temporäre Speicherung verwendet wird. Dateisysteme vermeiden das Zurückschreiben von Daten in den Massenspeicher, wenn genügend Cachespeicher verfügbar ist, da in der Regel eine Anwendung eine temporäre Datei löscht, nachdem das Handle geschlossen wurde. In diesem Szenario kann das System das Schreiben der Daten vollständig vermeiden. Andernfalls werden die Daten geschrieben, nachdem das Handle geschlossen wurde.
FILE_ATTRIBUTE_VIRTUAL
65536 (0x10000)
Dieser Wert ist für die Verwendung durch das System reserviert.

FileNameLength

Die Länge des Dateinamens.

EaSize

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

ReparsePointTag

Wenn das FileAttributes-Element das attribut FILE_ATTRIBUTE_REPARSE_POINT enthält, gibt dieses Element das Analysepunkttag an.

Andernfalls ist dieser Wert nicht definiert und sollte nicht verwendet werden.

Weitere Informationen finden Sie unter Analysepunkttags.

IO_REPARSE_TAG_CSV (0x80000009)

IO_REPARSE_TAG_DEDUP (0x80000013)

IO_REPARSE_TAG_DFS (0x8000000A)

IO_REPARSE_TAG_DFSR (0x80000012)

IO_REPARSE_TAG_HSM (0xC0000004)

IO_REPARSE_TAG_HSM2 (0x80000006)

IO_REPARSE_TAG_MOUNT_POINT (0xA0000003)

IO_REPARSE_TAG_NFS (0x80000014)

IO_REPARSE_TAG_SIS (0x80000007)

IO_REPARSE_TAG_WIM (0x80000008)

FileId

Die Datei-ID.

FileName[1]

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Kopfzeile winbase.h (einschließlich Windows.h)

Weitere Informationen

FILE_ID_128

FILE_INFO_BY_HANDLE_CLASS

Strukturen in der Dateiverwaltung

GetFileInformationByHandleEx