Exporter (0) Imprimer
Développer tout
and
div
eof
not
or
xor
Développer Réduire
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

_findnext, _wfindnext

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

handle

Recherchez le descripteur retourné par un appel précédent à _findfirst.

fileinfo

Mémoire tampon de l'Information fichier.

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.

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

Function

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.

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft