_findnext, _wfindnext

Article
06/09/2015

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

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
Recherchez le descripteur retourné par un appel précédent à _findfirst.
fileinfo
Mémoire tampon de l'Information fichier.

Valeur de retour

En cas de réussite, retourne 0. Sinon, retourne – 1 et affecte errno à une valeur qui indique la nature de l'erreur. Les codes d'erreur possibles sont répertoriés dans le tableau suivant.

EINVAL
Paramètre non valide: fileinfo était NULL. Ou, le système d'exploitation a retourné une erreur inattendue.
ENOENT
Plus aucun fichierscorrespondant n'a pu être détecté.
ENOMEM
Mémoire insuffisante ou la longueur du nom de fichier a dépassé MAX_PATH.

Si un paramètre non valide a été passé, ces fonctions appellent le gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre.

Notes

Vous devez appeler _findclose au terme de l'utilisation de la fonction _findfirst ou de la fonction _findnext (ou toutes variantes). Cela libère les ressources utilisées par ces fonctions dans votre application.

Les variations de ces fonctions avec le préfixe w sont des versions de caractères larges ; sinon, elles sont identiques aux fonctions codées sur un octet correspondantes.

Les variations de ces fonctions prennent en charge les types d'heure 32 bits ou 64 bits et les fichiers de taille 32 bits ou 64 bits. Le premier suffixe numérique (32 ou 64) indique la taille du type de temps 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 quelles versions prennent en charge les types d'heure 32 bits et 64 bits et les tailles de fichiers, consultez le tableau suivant. Les variations qui utilisent un type d'heure 64 bits permettent aux dates de création FILE d'être exprimées jusqu'à 23:59:59, le 31 décembre, 3000, UTC ; alors que celles utilisant les types d'heure 32 bits uniquement représentent les dates jusqu'à 19:14:07, le 18 janvier, 2038, UTC. Minuit, le 1er janvier 1970, est la limite inférieure de la plage de dates pour ces deux fonctions.

À moins d'avoir une raison particulière d'utiliser les versions qui spécifient la taille de temps explicitement, utilisez _findnext ou _wfindnext ou, si vous avez besoin de supporter des tailles de fichier supérieures à 3Go , utilisez _findnexti64 ou _wfindnexti64. Toutes ces fonctions utilisent le type d'heure 64 bits. Dans les versions antérieures, ces fonctions ont utilisé le type d'heure 32 bits. S'il s'agit d'une modification importante pour une application, vous pouvez définir _USE_32BIT_TIME_T pour obtenir le comportement antérieur. Si _USE_32BIT_TIME_T est défini, _findnext, _finnexti64 et leurs versions correspondantes Unicode utilisent une heure 32 bits.

Type d'Heure et Variation du Type de Longueur de Fichier de _findnext

Fonctions	_USE_32BIT_TIME_T défini?	Type de Temps	Type de taille de fichier
_findnext, _wfindnext	Non défini	64 bits	32 bits
_findnext, _wfindnext	(défini par)	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 par)	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

Configuration requise

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 Compatibilité dans l'introduction.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Voir aussi

Référence

Appels système

_find, _wfind, fonctions

Partager via