WIN32_FIND_DATAW-Struktur (minwinbase.h)
Enthält Informationen zu der Datei, die von der FindFirstFile-, FindFirstFileEx- oder FindNextFile-Funktion gefunden wird.
Syntax
typedef struct _WIN32_FIND_DATAW {
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD dwReserved0;
DWORD dwReserved1;
WCHAR cFileName[MAX_PATH];
WCHAR cAlternateFileName[14];
DWORD dwFileType; // Obsolete. Do not use.
DWORD dwCreatorType; // Obsolete. Do not use
WORD wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAW, *PWIN32_FIND_DATAW, *LPWIN32_FIND_DATAW;
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) |