_findnext, _wfindnext

Article
03/04/2013

Recherchez le nom suivant, le cas échéant, correspondant à l'argument d' filespec dans un appel précédent à _findfirst, puis modifiez le contenu de structure d' 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 handle retourné par un appel précédent à _findfirst.
fileinfo
Mémoire tampon informations sur le fichier.

Valeur de retour

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

EINVAL
paramètre non valide : fileinfo était NULL.ou, le système d'exploitation est retourné une erreur inattendue.
ENOENT
Plus de fichiers correspondants n'ont pu être trouvé.
ENOMEM
Pas assez de mémoire et la longueur du nom de fichier dépasse MAX_PATH.

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

Notes

Vous devez appeler _findclose lorsque vous avez terminé d'utiliser _findfirst ou la fonction d' _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 d' w sont des versions à caractères larges ; sinon, elles sont identiques aux fonctions codées sur un octet correspondantes.

Variantes des tailles des fichiers 32 bits ou type d'heure 64 bits et 32 bits ou 64 bits de prise en charge ces fonctions.le premier suffixe numérique (32 ou 64) indique la taille du type de temps utilisé ; le deuxième suffixe est i32 ou i64, indiquant si la taille du fichier est représentée sous la forme 32 bits ou entier 64 bits.Des informations concernant le lequel les versions prennent en charge 32 bits et des types d'heure 64 bits et les tailles de fichiers, consultez le tableau suivant.Les variations qui utilisent un type d'heure 64 bits accordent les dates de fichier-création à exprimer via le 23h59 : 59, le 31 décembre, 3000, l'heure UTC ; alors que celles utilisant des types d'heure 32 bits ne représentent que les dates via le 19h14 : Le 7 janvier 18, 2038, l'heure UTC.Minuit, le 1er janvier 1970, correspond à la limite inférieure de la plage de dates pour toutes ces fonctions.

À moins que vous ayez une raison spécifique pour utiliser des versions qui spécifient la taille de temps explicitement, l'utilisation _findnext ou _wfindnext ou, si vous avez besoin Go supérieur de tailles de fichiers de support à 3, utilisez _findnexti64 ou _wfindnexti64.toutes ces fonctions utilisent le type d'heure 64 bits.Dans les versions antérieures, ces fonctions ont utilisé un type d'heure 32 bits.S'il s'agit d'une modification avec rupture 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, _finnexti64 et leurs versions correspondantes Unicode utilisent l'heure 32 bits.

Calculez des variations de type et de longueur de fichier du _findnext

Fonctions	_USE_32BIT_TIME_T a défini ?	Le temps passé dans le type	Type de longueur du 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 de 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 de compatibilité, consultez compatibilité dans l'introduction.

bibliothèques

toutes les versions de Bibliothèques runtime C.

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' exemples d'appel de code non managé.

Voir aussi

Référence

Appels système

_find, fonctions de _wfind

Partager via