WIN32_FIND_DATAA-Struktur (minwinbase.h)

Artikel
02/29/2024

Enthält Informationen zu der Datei, die von der FindFirstFile-, FindFirstFileEx- oder FindNextFile-Funktion 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;

Member

dwFileAttributes

Die Dateiattribute einer Datei.

Mögliche Werte und ihre Beschreibungen finden Sie unter Dateiattributekonstanten.

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

ftCreationTime

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

Wenn das zugrunde liegende Dateisystem keine Erstellungszeit unterstützt, ist dieser Member 0.

ftLastAccessTime

Eine FILETIME-Struktur .

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

Für ein Verzeichnis gibt die Struktur an, wann das Verzeichnis erstellt wird. Wenn das zugrunde liegende Dateisystem die Uhrzeit des letzten Zugriffs nicht unterstützt, ist dieser Member 0.

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

ftLastWriteTime

Eine FILETIME-Struktur .

Für eine Datei gibt die Struktur an, wann die Datei zuletzt in geschrieben, abgeschnitten oder überschrieben wurde, z. B. wenn WriteFile oder SetEndOfFile verwendet werden. Das Datum und die Uhrzeit werden nicht aktualisiert, wenn Dateiattribute oder Sicherheitsbeschreibungen geändert werden.

Für ein Verzeichnis gibt die Struktur an, wann das Verzeichnis erstellt wird. Wenn das zugrunde liegende Dateisystem die Letzte Schreibzeit nicht unterstützt, ist dieser Member 0.

nFileSizeHigh

Der hohe DWORD-Wert der Dateigröße in Bytes.

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

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

nFileSizeLow

Der DWORD-Wert mit niedriger Reihenfolge der Dateigröße in Bytes.

dwReserved0

Wenn das dwFileAttributes-Element das attribut FILE_ATTRIBUTE_REPARSE_POINT enthält, gibt dieses Element das Reparsepunkttag an.

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

Weitere Informationen finden Sie unter Analysieren von Punkttags.

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

Für die zukünftige Verwendung reserviert.

cFileName[MAX_PATH]

Der Name der Datei.

cAlternateFileName[14]

Ein alternativer Name für die Datei.

Dieser Name hat das klassische Dateiformat 8.3.

Hinweise

Wenn eine Datei einen langen Dateinamen hat, wird der vollständige Name im cFileName-Element angezeigt, und die abgeschnittene Version des Namens 8.3 wird im Element cAlternateFileName angezeigt. Andernfalls ist cAlternateFileName leer. Wenn die FindFirstFileEx-Funktion mit dem Wert FindExInfoBasic im fInfoLevelId-Parameter aufgerufen wurde, enthält das cAlternateFileName-Element immer einen NULL-Zeichenfolgenwert . Dies gilt weiterhin 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 die Zeiten der Erstellung und des letzten Zugriffs aufzeichnen, und nicht alle Dateisysteme erfassen sie auf die gleiche Weise. Im FAT-Dateisystem hat die Erstellungszeit beispielsweise eine Auflösung von 10 Millisekunden, die Schreibzeit eine Auflösung von 2 Sekunden und die Zugriffszeit eine Auflösung von 1 Tag. Das NTFS-Dateisystem verzögert Updates bis zur letzten Zugriffszeit für eine Datei um bis zu eine Stunde nach dem letzten Zugriff. Weitere Informationen finden Sie unter Dateizeiten.

Hinweis

Der header minwinbase.h definiert WIN32_FIND_DATA als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Kopfzeile	minwinbase.h (einschließlich Windows.h)