_findnext, _wfindnext

Artikel
02/26/2013

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

Freigeben über