WIN32_FIND_DATAA Struktur (minwinbase.h)

Enthält Informationen zu der Datei, die von der funktion FindFirstFile, FindFirstFileExoder FindNextFile gefunden wird.

Syntax

typedef struct _WIN32_FIND_DATAA {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    dwReserved0;
  DWORD    dwReserved1;
  CHAR     cFileName[MAX_PATH];
  CHAR     cAlternateFileName[14];
  DWORD    dwFileType; // Obsolete. Do not use.
  DWORD    dwCreatorType; // Obsolete. Do not use
  WORD     wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAA, *PWIN32_FIND_DATAA, *LPWIN32_FIND_DATAA;

Angehörige

dwFileAttributes

Die Dateiattribute einer Datei.

Mögliche Werte und deren Beschreibungen finden Sie unter File Attribute Constants.

Das FILE_ATTRIBUTE_SPARSE_FILE Attribut für die Datei wird festgelegt, wenn einer der Datenströme der Datei jemals sparsam war.

ftCreationTime

Eine FILETIME- Struktur, die angibt, wann eine Datei oder ein Verzeichnis erstellt wurde.

Wenn das zugrunde liegende Dateisystem die Erstellungszeit nicht unterstützt, ist dieses Element null.

ftLastAccessTime

Eine FILETIME- Struktur.

Bei einer Datei gibt die Struktur an, wann die Datei zuletzt ausgelesen, in oder für ausführbare Dateien gelesen wurde.

Bei einem Verzeichnis gibt die Struktur an, wann das Verzeichnis erstellt wird. Wenn das zugrunde liegende Dateisystem den letzten Zugriff nicht unterstützt, ist dieses Element null.

Im FAT-Dateisystem ist das angegebene Datum für Dateien und Verzeichnisse korrekt, aber die Tageszeit wird immer auf Mitternacht festgelegt.

ftLastWriteTime

Eine FILETIME- Struktur.

Bei einer Datei gibt die Struktur an, wann die Datei zuletzt geschrieben, abgeschnitten oder überschrieben wurde, z. B. wenn WriteFile- oder SetEndOfFile- verwendet werden. Das Datum und die Uhrzeit werden nicht aktualisiert, wenn Dateiattribute oder Sicherheitsdeskriptoren geändert werden.

Bei einem Verzeichnis gibt die Struktur an, wann das Verzeichnis erstellt wird. Wenn das zugrunde liegende Dateisystem die letzte Schreibzeit nicht unterstützt, ist dieses Element null.

nFileSizeHigh

Die hohe Reihenfolge DWORD- Wert der Dateigröße in Byte.

Dieser Wert ist null, es sei denn, die Dateigröße ist größer als MAXDWORD-.

Die Größe der Datei ist gleich (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLow.

nFileSizeLow

Die niedrige Reihenfolge DWORD- Wert der Dateigröße in Byte.

dwReserved0

Wenn das dwFileAttributes Member 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 Reparse Point Tags.

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_SYMLINK (0xA000000C)

IO_REPARSE_TAG_WIM (0x80000008)

dwReserved1

Reserviert für die zukünftige Verwendung.

cFileName[MAX_PATH]

Der Name der Datei.

cAlternateFileName[14]

Ein alternativer Name für die Datei.

Dieser Name befindet sich im klassischen 8.3-Dateiformat.

Bemerkungen

Wenn eine Datei einen langen Dateinamen hat, wird der vollständige Name im cFileName Member angezeigt, und das 8.3-Format wird abgeschnittene Version des Namens im cAlternateFileName Member angezeigt. Andernfalls ist "cAlternateFileName"- leer. Wenn die FindFirstFileEx--Funktion mit dem Wert FindExInfoBasic- im fInfoLevelId-Parameter aufgerufen wurde, enthält das cAlternateFileName Member immer einen NULL- Zeichenfolgenwert. Dies gilt für alle nachfolgenden Aufrufe der FindNextFile--Funktion. Als alternative Methode zum Abrufen der 8.3-Formatversion eines Dateinamens können Sie die GetShortPathName--Funktion verwenden. Weitere Informationen zu Dateinamen finden Sie unter Dateinamen, Pfade und Namespaces.

Nicht alle Dateisysteme können erstellungs- und letzte Zugriffszeiten aufzeichnen, und nicht alle Dateisysteme zeichnen sie auf die gleiche Weise auf. Beispielsweise hat die Erstellungszeit im FAT-Dateisystem eine Auflösung von 10 Millisekunden, die Schreibzeit hat eine Auflösung von 2 Sekunden, und die Zugriffszeit hat eine Auflösung von 1 Tag. Das NTFS-Dateisystem verzögert Aktualisierungen der letzten Zugriffszeit für eine Datei um bis zu 1 Stunde nach dem letzten Zugriff. Weitere Informationen finden Sie unter File Times.

Anforderungen

Siehe auch

FILETIME-

Dateiattributekonstanten

Dateinamen, Pfade und Namespaces

Dateizeiten

FileTimeToLocalFileTime-

FileTimeToSystemTime-

FindFirstFile-

FindFirstFileEx-

FindNextFile-

GetShortPathName-