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.
Anmerkung
Der minwinbase.h-Header definiert WIN32_FIND_DATA als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Header- | minwinbase.h (include Windows.h) |