Partager via


_findnext, , _findnext32, _findnext64, , _findnexti64_wfindnext64_wfindnext64i32_wfindnext_wfindnext32i64_wfindnext32_findnext64i32_findnext32i64_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 routines de texte générique

Routine Tchar.h _UNICODE et _MBCS non définis _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