_findnext, _findnext32, _findnext32i64, _findnext64, _findnext64i32, _findnexti64, _wfindnext, _wfindnext32, _wfindnext32i64, _wfindnext64, _wfindnext64i32, _wfindnexti64

Recherchez le nom suivant, le cas échéant, qui correspond à l’argument filespec d’un appel précédent, _findfirstpuis modifiez le contenu de la fileinfo structure en conséquence.

Syntaxe

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
);

Paramètres

handle
Handle de recherche retourné par un appel précédent à _findfirst.

fileinfo
Mémoire tampon des informations du fichier.

Valeur retournée

En cas de réussite, retourne 0. Sinon, retourne -1 et définit errno une valeur indiquant la nature de l’échec. Les codes d’erreur possibles sont présentés dans le tableau suivant.

Valeur errno	Condition
EINVAL	Paramètre non valide : fileinfo était NULL. Ou bien, le système d’exploitation a retourné une erreur inattendue.
ENOENT	Aucun autre fichier correspondant n’a été trouvé.
ENOMEM	Mémoire insuffisante ou longueur du nom de fichier supérieure MAX_PATH.

Si un paramètre non valide est passé, ces fonctions appellent le gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres.

Notes

Vous devez appeler une fois que vous avez terminé d’utiliser _findclose la ou la _findfirst_findnext fonction (ou toutes les variantes). _findclose libère les ressources utilisées par ces fonctions dans votre application.

Les variantes de ces fonctions avec le préfixe w sont des versions à caractères larges ; sinon, elles sont identiques aux fonctions monooctets correspondantes.

Les variantes de ces fonctions prennent en charge les types d’heures 32 bits ou 64 bits, ainsi que les tailles de fichiers 32 bits ou 64 bits. Le premier suffixe numérique (32 ou 64) indique la taille du type d’heure utilisé ; le deuxième suffixe est i32 ou i64, qui indique si la taille du fichier est représentée comme un entier 32 bits ou 64 bits. Pour plus d’informations sur les versions qui prennent en charge les tailles de fichiers et les types d’heures 32 bits et 64 bits, consultez le tableau suivant. Les variantes qui utilisent un type d’heure 64 bits permettent d’exprimer les dates de création de fichiers jusqu’au 31 décembre 3000 à 23:59:59 heure UTC, tandis que celles qui utilisent des types d’heure 32 bits représentent uniquement les dates jusqu’au 18 janvier 2038 à 23:59:59, heure UTC. Le 1er janvier 1970 à minuit est la limite inférieure de la plage de dates pour toutes ces fonctions.

Sauf si vous devez absolument utiliser les versions qui spécifient de manière explicite la taille de l’heure, utilisez _findnext ou _wfindnext ou, si vous avez besoin de prendre en charge des tailles de fichier supérieures à 3 Go, utilisez _findnexti64 ou _wfindnexti64. Toutes ces fonctions utilisent le type d’heure 64 bits. Dans les versions antérieures, ces fonctions utilisaient un type d’heure 32 bits. Si cette modification est une modification cassant pour une application, vous pouvez définir _USE_32BIT_TIME_T pour obtenir l’ancien comportement. Si _USE_32BIT_TIME_T est défini, _findnext, _findnexti64 et les versions Unicode correspondantes utilisent une heure 32 bits.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Variantes de type d’heure et de type de longueur de fichier _findnext

Functions	_USE_32BIT_TIME_T défini ?	Type de temps	Type de longueur de fichier
_findnext, _wfindnext	Non défini	64 bits	32 bits
_findnext, _wfindnext	Défini	32 bits	32 bits
_findnext32, _wfindnext32	Non affecté par la définition de macro	32 bits	32 bits
_findnext64, _wfindnext64	Non affecté par la définition de macro	64 bits	64 bits
_findnexti64, _wfindnexti64	Non défini	64 bits	64 bits
_findnexti64, _wfindnexti64	Défini	32 bits	64 bits
_findnext32i64, _wfindnext32i64	Non affecté par la définition de macro	32 bits	64 bits
_findnext64i32, _wfindnext64i32	Non affecté par la définition de macro	64 bits	32 bits

Mappages de routine de texte générique

Routine Tchar.h	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tfindnext	_findnext	_findnext	_wfindnext
_tfindnext32	_findnext32	_findnext32	_wfindnext32
_tfindnext64	_findnext64	_findnext64	_wfindnext64
_tfindnexti64	_findnexti64	_findnexti64	_wfindnexti64
_tfindnext32i64	_findnext32i64	_findnext32i64	_wfindnext32i64
_tfindnext64i32	_findnext64i32	_findnext64i32	_wfindnext64i32

Spécifications

Fonction	En-tête requis
_findnext	<io.h>
_findnext32	<io.h>
_findnext64	<io.h>
_findnexti64	<io.h>
_findnext32i64	<io.h>
_findnext64i32	<io.h>
_wfindnext	<io.h> ou <wchar.h>
_wfindnext32	<io.h> ou <wchar.h>
_wfindnext64	<io.h> ou <wchar.h>
_wfindnexti64	<io.h> ou <wchar.h>
_wfindnext32i64	<io.h> ou <wchar.h>
_wfindnext64i32	<io.h> ou <wchar.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Voir aussi

Appels système
Fonctions de recherche de nom de fichier