_findnext, __wfindnext
Nach oben zu io.h - Index
Header-Datei
io.h, wchar.h
Kategorie
Verzeichnisbearbeitungsroutinen
Prototyp
long _findnext(long handle, struct _finddata_t *fileinfo);
long __wfindnext(long handle, struct _wfinddata_t *fileinfo);
Beschreibung
Findet nachfolgende Dateien, sofern vorhanden, die dem Argument filter eines vorherigen Aufrufs von _findfirst/__wfindfirst entsprechen. Danach aktualisiert _findfirst/__wfindfirst die Struktur fileinfo mit den Daten, die zur Fortsetzung der Suche erforderlich sind. Mit jedem Aufruf von _tfindnext wird ein Dateiname zurückgegeben, bis in dem Verzeichnis mit dem angegebenen Pfadnamen (filter) keine weiteren Dateien gefunden werden.
Bei dem Parameter handle handelt es sich um das Such-Handle, das vom vorherigen Aufruf von _findfirst zurückgegeben wurde. Der Parameter fileinfo steht für den Dateiinformationspuffer.
Diese Funktionen werden aus Gründen der Kompatibilität mit Microsoft bereitgestellt.
Rückgabewert
Bei erfolgreicher Ausführung gibt die Funktion 0 zurück.
Andernfalls wird –1 zurückgegeben und errno einer der folgenden Werte zugewiesen:
ENOENT File specification that could not be matched (Datei oder Verzeichnis nicht gefunden)
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
_findnext |
+ |
|||
__wfindnext |
Nur NT |