_findnext, _wfindnext

Suchen Sie den folgenden Namen ggf. der das filespec-Argument in einem vorherigen Aufruf an _findfirst entspricht, und ändern Sie dann den fileinfo-Strukturinhalt entsprechend.

int _findnext(
   intptr_t handle,
   struct _finddata_t *fileinfo 
);
int _findnext32(
   intptr_t handle,
   struct _finddata32_t *fileinfo 
);
int _findnext64(
   intptr_t handle,
   struct __finddata64_t *fileinfo 
);
int _findnexti64(
   intptr_t handle,
   struct __finddatai64_t *fileinfo 
);
int _findnext32i64(
   intptr_t handle,
   struct _finddata32i64_t *fileinfo 
);
int _findnext64i32(
   intptr_t handle,
   struct _finddata64i32_t *fileinfo 
);
int _wfindnext(
   intptr_t handle,
   struct _wfinddata_t *fileinfo 
);
int _wfindnext32(
   intptr_t handle,
   struct _wfinddata32_t *fileinfo 
);
int _wfindnext64(
   intptr_t handle,
   struct _wfinddata64_t *fileinfo 
);
int _wfindnexti64(
   intptr_t handle,
   struct _wfinddatai64_t *fileinfo 
);
int _wfindnext32i64(
   intptr_t handle,
   struct _wfinddatai64_t *fileinfo 
);
int _wfindnext64i32(
   intptr_t handle,
   struct _wfinddata64i32_t *fileinfo 
);

Parameter

• handle
  Suchen Sie das Handle, das bei einem vorherigen Aufruf von _findfirst zurückgegeben wird.

• fileinfo
  Dateiinformationspuffer.

Rückgabewert

Wenn erfolgreich, gibt 0 zurück. Andernfalls gibt - 1 und legt errno auf einen Wert, der die Art des Fehlers angibt. Mögliche Fehlercodes werden in der folgenden Tabelle dargestellt.

• EINVAL
  Ungültiger Parameter: fileinfo war NULL. Oder, das Betriebssystem hat einen unerwarteten Fehler zurück.

• ENOENT
  Nicht mehr entsprechende Dateien gefunden werden können.

• ENOMEM
  Nicht genügend Speicher oder die Länge von Dateinamen überschritten MAX_PATH.

Wenn ein ungültiger Parameter übergeben wird, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben.

Hinweise

Sie müssen _findclose aufrufen, nachdem Sie entweder mit _findfirst oder _findnext-Funktion beendet wurde (oder alle Varianten). Dies gibt es Ressourcen frei, die durch diese Funktionen in der Anwendung verwendet werden.

Die Variationen dieser Funktionen mit dem Präfix w sind Breitzeichenversionen; andernfalls sind sie zu den entsprechenden Einzelbytefunktionen identisch.

Varianten der 32-Bit- oder 64-Bit-Zeit dieser Funktionen Stützgibt und der 32-Bit- oder 64-Bit-Dateigrößen ein. Das erste numerische Suffix (32 oder 64) gibt die Größe des verwendeten Zeittyps an; das zweite Suffix ist entweder i32 oder i64 angibt, ob die Dateigröße als 32-Bit- oder 64-Bit-ganzeZahl dargestellt wird. Informationen darüber, welche Versionen 32-Bit- und 64-Bit-Zeittypen und -Dateigrößen unterstützen, finden Sie die folgende Tabelle. Die Variationen, die einen 64-Bit-Zeittyp verwenden, bieten bis 23:59 die oben angegeben werden können, DateiErstellungsdatumsangaben: 59 3000 am 31. Dezember, UTC; während die mithilfe der 32-Bit-Zeittypen nur Datumsangaben von 19:14 darstellen: Am 7. Januar 18 2038, UTC. Mitternacht am 1. Januar 1970 ist die untere Begrenzung des Zeitraums für alle diese Funktionen.

Sofern, dass Sie einen bestimmten Grund haben, die Versionen verwenden, die der Zeitgröße explizit angeben, wird mit _findnext oder _wfindnext oder, wenn Sie Unterstützungsdateigrößen größer als 3 GB benötigen, _findnexti64 oder _wfindnexti64. Alle diese Funktionen verwenden den 64-Bit-Zeittyp. In früheren Versionen wurde diese Funktionen einen 32-Bit-Zeittyp. Wenn dies eine Änderung für eine Anwendung ist, können Sie _USE_32BIT_TIME_T, um das alte Verhalten abzurufen. Wenn _USE_32BIT_TIME_T definiert wurde, verwenden _findnext, _finnexti64 und ihre entsprechenden Unicode-Versionen eine 32-Bit-Zeit.

Die Zeit Typs fest und fügen Sie Längen-Typ-Variationen von _findnext

Zuordnung generischer Textroutinen

Anforderungen

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Bibliotheken

Alle Versionen C-Laufzeitbibliotheken.

.NET Framework-Entsprechung

Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.

Siehe auch

Referenz

Systemaufrufe

_find- und _wfind-Funktionen