_findnext, _wfindnext

Suchen Sie den folgenden Namen filespec wenn eine der das Argument in einem vorherigen Aufruf an _findfirstentspricht, und ändern Sie dann die fileinfo Inhalt der Struktur entspricht.

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 durch einen vorherigen Aufruf von _findfirstzurückgegeben wurde.

  • fileinfo
    Dateiinformationens Puffer.

Rückgabewert

Bei Erfolg gibt 0 zurück.Andernfalls gibt 1 zurück und legt errno auf einen Wert fest, 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
    Übereinstimmende Dateien konnten nicht mehr gefunden werden.

  • ENOMEM
    Nicht genügend Arbeitsspeicher oder die Länge des Dateinamens überschritten MAX_PATH.

Wenn ein ungültiger Parameter übergeben wird, wird diese Funktionen der ungültige Parameter für ein, wie in Parametervalidierungbeschrieben.

Hinweise

Sie müssen _findclose aufrufen, nachdem Sie entweder mit _findfirst oder _findnext-Funktion beendet wurden (oder alle Varianten).Dadurch wird die Ressourcen frei, die von diesen Funktionen in der Anwendung verwendet werden.

Die Variationen dieser Funktionen mit dem Präfix w Breitzeichenversionen sind. Andernfalls sind sie ein Byte an die entsprechenden Funktionen identisch.

Variationen dieser Funktion stütz32-bit- oder 64 bit-Zeit Typen und 32-Bit- oder 64-Bit-Dateigrößen.Im ersten numerischen Suffix (32 oder 64) gibt die Größe des Typs Zeit verwenden. Suffix das zweite i64oder i32 ist, und gibt an, ob die Dateigröße als 32-Bit- oder 64-Bit-ganze Zahl dargestellt wird.Weitere Informationen darüber, welche Versionen 64-Bit-Zeit 32-Bit- und Typen und Dateigrößen unterstützen, finden Sie unter in der folgenden Tabelle.Die Variationen, die einen Typ 64-Bit-Zeit verwenden, bieten und 23:59 oben ausgedrückt werden: Datumsangaben Build FILE59 3000 am 31. Dezember, UTC. wohingegen die mithilfe der 32-Bit-Zeit Typen nur Datumsangaben nach 19:14 Uhr darstellen: Am 7. Januar 18 2038, UTC.Mitternacht am 1. Januar 1970 ist die Untergrenze des Datumsbereichs für alle diese Features.

Sofern Sie keinen bestimmten Grund auch zu verwenden, die die Größe der Zeit explizit angeben, verwendet _findnext oder _wfindnext verwenden, oder wenn Sie die Unterstützungsdatei dateigrößen benötigen, die größer als 3 GB sind, _findnexti64 oder _wfindnexti64.Alle diese Funktionen verwenden den Typ der 64-Bit-Zeit.In früheren Versionen wurden diese Funktionen 32-Bit-Zeit einen Typ.Wenn dies eine Änderung für eine Anwendung ist, so definiert werden _USE_32BIT_TIME_T Sie das alte Verhalten abzurufen.Wenn _USE_32BIT_TIME_T definiert ist, verwenden _findnext, _finnexti64 und ihre entsprechenden Unicode-Versionen einer 32-Bit-Zeit.

Legen Sie die Uhrzeit fest _findnext von Datei-Längen-Typ-Variationen Typ-und

Funktionen

_USE_32BIT_TIME_T definierte?

Typ der Uhrzeit

Typ der Dimension Datei

_findnext, _wfindnext

Nicht definiert

64 Bit

32-Bit

_findnext, _wfindnext

Definiert

32-Bit

32-Bit

_findnext32, _wfindnext32

Keine Auswirkung von der Makrodefinition

32-Bit

32-Bit

_findnext64, _wfindnext64

Keine Auswirkung von der Makrodefinition

64 Bit

64 Bit

_findnexti64, _wfindnexti64

Nicht definiert

64 Bit

64 Bit

_findnexti64, _wfindnexti64

Definiert

32-Bit

64 Bit

_findnext32i64, _wfindnext32i64

Keine Auswirkung von der Makrodefinition

32-Bit

64 Bit

_findnext64i32, _wfindnext64i32

Keine Auswirkung von der Makrodefinition

64 Bit

32-Bit

Zuweisung generischer Textroutinen

Tchar.h-Routine

_UNICODE als auch _MBCS nicht definiert

_MBCS definieren

_UNICODE definiert

_tfindnext

_findnext

_findnext

_wfindnext

_tfindnext32

_findnext32

_findnext32

_wfindnext32

_tfindnext64

_findnext64

_findnext64

_wfindnext64

_tfindnexti64

_findnexti64

_findnexti64

_wfindnexti64

_tfindnext32i64

_findnext32i64

_findnext32i64

_wfindnext32i64

_tfindnext64i32

_findnext64i32

_findnext64i32

_wfindnext64i32

Anforderungen

Funktion

Erforderlicher Header

_findnext

<io.h>

_findnext32

<io.h>

_findnext64

<io.h>

_findnexti64

<io.h>

_findnext32i64

<io.h>

_findnext64i32

<io.h>

_wfindnext

<io.h> oder <wchar.h>

_wfindnext32

<io.h> oder <wchar.h>

_wfindnext64

<io.h> oder <wchar.h>

_wfindnexti64

<io.h> oder <wchar.h>

_wfindnext32i64

<io.h> oder <wchar.h>

_wfindnext64i32

<io.h> oder <wchar.h>

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

Bibliotheken

Alle Versionen Cs.

.NET Framework-Entsprechung

Nicht zutreffend. Um die Standard-C-Funktion aufrufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Plattformaufruf-Beispiele.

Siehe auch

Referenz

Systemaufrufe

_find, _wfind Funktionen