_findnexti64, _wfindnexti64

Aus RAD Studio
Wechseln zu: Navigation, Suche

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