FindNextFileA-Funktion (fileapi.h)

Artikel
08/23/2023

Setzt eine Dateisuche aus einem vorherigen Aufruf der Funktionen FindFirstFile, FindFirstFileEx oder FindFirstFileTransacted fort.

Syntax

BOOL FindNextFileA(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAA lpFindFileData
);

Parameter

[in] hFindFile

Das Suchhandle, das von einem vorherigen Aufruf der FindFirstFile- oder FindFirstFileEx-Funktion zurückgegeben wurde.

[out] lpFindFileData

Ein Zeiger auf die WIN32_FIND_DATA-Struktur , die Informationen über die gefundene Datei oder das unterverzeichnis empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null, und der parameter lpFindFileData enthält Informationen über die nächste gefundene Datei oder das nächste gefundene Verzeichnis.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null, und der Inhalt von lpFindFileData ist unbestimmt. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

Wenn die Funktion fehlschlägt, weil keine übereinstimmenden Dateien mehr gefunden werden können, gibt die GetLastError-FunktionERROR_NO_MORE_FILES zurück.

Hinweise

Diese Funktion verwendet dieselben Suchfilter, die zum Erstellen des Suchhandles verwendet wurden, das im Parameter hFindFile übergeben wurde. Weitere Informationen finden Sie unter FindFirstFile und FindFirstFileEx.

Die Reihenfolge, in der die Suche die Dateien zurückgibt, z. B. die alphabetische Reihenfolge, ist nicht garantiert und hängt vom Dateisystem ab. Wenn die Daten sortiert werden müssen, muss die Anwendung die Reihenfolge durchführen, nachdem alle Ergebnisse abgerufen wurden.

Hinweis In seltenen Fällen oder auf einem stark geladenen System sind Dateiattributeinformationen auf NTFS-Dateisystemen zum Zeitpunkt des Aufrufs dieser Funktion möglicherweise nicht aktuell. Rufen Sie die GetFileInformationByHandle-Funktion auf, um die aktuellen NTFS-Dateisystemdateiattribute abzurufen.

Die Reihenfolge, in der diese Funktion die Dateinamen zurückgibt, hängt vom Dateisystemtyp ab. Bei den Dateisystemen NTFS und CDFS werden die Namen in der Regel in alphabetischer Reihenfolge zurückgegeben. Bei FAT-Dateisystemen werden die Namen in der Regel in der Reihenfolge zurückgegeben, in der die Dateien auf den Datenträger geschrieben wurden, die in alphabetischer Reihenfolge vorliegen oder nicht. Wie bereits erwähnt, sind diese Verhaltensweisen jedoch nicht garantiert.

Wenn der Pfad auf einen symbolischen Link zeigt, enthält der Puffer WIN32_FIND_DATA Informationen zum symbolischen Link, nicht das Ziel.

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

Transaktionierte Vorgänge

Ist an das Handle für die Dateienumeration eine Transaktion gebunden, unterliegen die zurückgegebenen Dateien den Regeln für die Isolation von Transaktionen.

Beispiele

Ein Beispiel finden Sie unter Auflisten der Dateien in einem Verzeichnis.

Hinweis

Der Fileapi.h-Header definiert FindNextFile 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
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	fileapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll