FindNextFileA-Funktion (fileapi.h)

Artikel
11/20/2024

Setzt eine Dateisuche aus einem vorherigen Aufruf der FindFirstFile-, FindFirstFileEx-oder FindFirstFileTransacted--Funktionen 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 wird.

[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 lpFindFileData Parameter enthält Informationen zur nächsten gefundenen Datei oder zum nächsten Gefundenen Verzeichnis.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null und der Inhalt lpFindFileData- unbestimmt. Rufen Sie zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion auf.

Wenn die Funktion fehlschlägt, da keine übereinstimmenden Dateien gefunden werden können, gibt die GetLastError--Funktion ERROR_NO_MORE_FILESzurück.

Bemerkungen

Diese Funktion verwendet dieselben Suchfilter, die zum Erstellen des im hFindFile Parameter übergebenen Suchhandle verwendet wurden. Weitere Informationen finden Sie unter FindFirstFile- und FindFirstFileEx-.

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

Hinweis In seltenen Fällen oder in einem stark geladenen System sind Dateiattributeinformationen auf NTFS-Dateisystemen möglicherweise nicht aktuell, wenn diese Funktion aufgerufen wird. Um sicherzustellen, dass die aktuellen NTFS-Dateisystemattribute abgerufen werden, rufen Sie die GetFileInformationByHandle--Funktion auf.

Die Reihenfolge, in der diese Funktion die Dateinamen zurückgibt, hängt vom Dateisystemtyp ab. Mit dem NTFS-Dateisystem und den CDFS-Dateisystemen 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, was sich möglicherweise in alphabetischer Reihenfolge befindet. Wie bereits erwähnt, sind diese Verhaltensweisen jedoch nicht garantiert.

Wenn der Pfad auf eine symbolische Verknüpfung zeigt, enthält der WIN32_FIND_DATA Puffer Informationen über die symbolische Verknüpfung, nicht das Ziel.

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

Technologie	Abgestützt
Server Message Block (SMB) 3.0-Protokoll	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Skalierungsdateifreigaben (SO)	Ja
Freigegebenes Clustervolumedateisystem (CsvFS)	Ja
Resilient File System (ReFS)	Ja

Transacted Operations

Wenn eine Transaktion an das Dateiaufzählungshandle gebunden ist, unterliegen die zurückgegebenen Dateien den Transaktionsisolationsregeln.

Beispiele

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

Anmerkung

Der Header fileapi.h 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
mindestens unterstützte Client-	Windows XP [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	fileapi.h (include Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll