_findnexti64, _wfindnexti64
Nach oben zu io.h - Index
Header-Datei
io.h, wchar.h
Kategorie
Verzeichnisbearbeitungsroutinen
Prototyp
long _findnexti64(long handle, struct _finddatai64_t *fileinfo);
__int64 _wfindnexti64(long handle, struct _wfinddata_t *fileinfo);
Beschreibung
Findet nachfolgende Dateien, sofern vorhanden, die dem Argument filter eines vorherigen Aufrufs von _findfirsti64/_wfindfirsti64 entsprechen. Danach aktualisiert _findfirsti64/_wfindfirsti64 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 i64-Versionen sind für die Verwendung von 64-Bit-Dateigrößen vorgesehen und 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)
Beispiel
#include <io.h>
void print_dir(wchar_t* dir_name)
{
/* Open a find stream (_wfinddatai64_t and a find handle) */
_wfinddatai64_t find_data;
long handle = _wfindfirsti64(dir_name, &find_data);
/* Check for errors */
if (!handle)
return;
/* Scan all files that mach */
do
{
printf("%ls\n", find_data.name);
} while (!'''_wfindnexti64'''(handle, &find_data));
/* Close the find handle */
_findclose(handle);
}
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
_findnexti64 |
+ |
|||
_wfindnexti64 |
Nur NT |