FindNextFileA-Funktion (fileapi.h)
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.
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 |