_findnext, _wfindnext
Busque el siguiente nombre, si existe, que coincide con el argumento de filespec en una llamada anterior a _findfirsty, a continuación modifique el contenido de la estructura de fileinfo en consecuencia.
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
);
Parámetros
handle
Identificador de búsqueda devuelto por una llamada anterior a _findfirst.fileinfo
Búfer de información de archivo.
Valor devuelto
Si finaliza correctamente, devuelve 0.De lo contrario, devuelve – 1 y establece errno a un valor que indica la naturaleza del error.los códigos de error posibles se muestran en la tabla siguiente.
EINVAL
Parámetro no válido: fileinfo era NULL.o, el sistema operativo devolvió un error inesperado.ENOENT
No más de archivos coincidentes podrían ser encontrados.ENOMEM
Memoria insuficiente o la longitud del nombre de archivo supera MAX_PATH.
Si se pasa un parámetro no válido en, estas funciones se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.
Comentarios
Debe llamar a _findclose cuando haya terminado de _findfirst o la función de _findnext (o cualquier variantes).Esto libera los recursos utilizados por estas funciones en la aplicación.
Las variaciones de estas funciones con el prefijo de w son versiones de carácter ancho; si no, son idénticas a las funciones correspondientes de un solo byte.
Las variaciones de estas funciones admiten tipos de 32 bits o de 64 bits de tiempo y tamaños de archivo de 32 bits o de 64 bits.El primer sufijo numérico (32 o 64) indica el tamaño del tipo de tiempo utilizado; el segundo sufijo es i32 o i64, que indica si el tamaño de archivo está representado como un entero de 32 bits o de 64 bits.Para obtener información sobre las versiones admiten tipos de 32 bits y 64 bits del tiempo y tamaños de archivo, vea la tabla siguiente.Las variaciones que utilizan un tipo de 64 bits de tiempo permiten que las fechas de creación de archivos se expresadas hacia arriba con 23:59: 59, el 31 de diciembre, 3000, hora UTC; mientras que los mediante tipos de 32 bits de tiempo representan sólo las fechas con 19:14: 7 de enero de 18, 2038, La hora UTC.La medianoche, el 1 de enero de 1970, es el límite inferior del intervalo de fechas para todas estas funciones.
A menos que tenga una razón concreta para usar las versiones que especifica el tamaño de tiempo explícitamente, el uso _findnext o _wfindnext o, si necesita los tamaños mayor de 3 GB de archivo auxiliar, utiliza _findnexti64 o _wfindnexti64.Todas estas funciones utilizan el tipo de 64 bits del tiempo.En versiones anteriores, estas funciones se utilizó un tipo de 32 bits del tiempo.Si éste es un cambio importante para una aplicación, puede definir _USE_32BIT_TIME_T para obtener el comportamiento antiguo.Si _USE_32BIT_TIME_T está definido, _findnext, _finnexti64 y sus correspondientes versiones de Unicode utilizan un plazo de 32 bits.
El tipo y el archivo Length de tiempo escriben variaciones de _findnext
Funciones |
¿_USE_32BIT_TIME_T definido? |
Tipo de tiempo |
Tipo de la longitud del archivo |
|---|---|---|---|
_findnext, _wfindnext |
no definido |
64 bits |
32 bits |
_findnext, _wfindnext |
Definido |
32 bits |
32 bits |
_findnext32, _wfindnext32 |
No se ve afectado por la definición de macro |
32 bits |
32 bits |
_findnext64, _wfindnext64 |
No se ve afectado por la definición de macro |
64 bits |
64 bits |
_findnexti64, _wfindnexti64 |
no definido |
64 bits |
64 bits |
_findnexti64, _wfindnexti64 |
Definido |
32 bits |
64 bits |
_findnext32i64, _wfindnext32i64 |
No se ve afectado por la definición de macro |
32 bits |
64 bits |
_findnext64i32, _wfindnext64i32 |
No se ve afectado por la definición de macro |
64 bits |
32 bits |
Asignaciones de la rutina de texto genérico
rutina de Tchar.h |
_UNICODE y _MBCS no definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_tfindnext |
_findnext |
_findnext |
_wfindnext |
_tfindnext32 |
_findnext32 |
_findnext32 |
_wfindnext32 |
_tfindnext64 |
_findnext64 |
_findnext64 |
_wfindnext64 |
_tfindnexti64 |
_findnexti64 |
_findnexti64 |
_wfindnexti64 |
_tfindnext32i64 |
_findnext32i64 |
_findnext32i64 |
_wfindnext32i64 |
_tfindnext64i32 |
_findnext64i32 |
_findnext64i32 |
_wfindnext64i32 |
Requisitos
Función |
Encabezado necesario |
|---|---|
_findnext |
<io.h> |
_findnext32 |
<io.h> |
_findnext64 |
<io.h> |
_findnexti64 |
<io.h> |
_findnext32i64 |
<io.h> |
_findnext64i32 |
<io.h> |
_wfindnext |
<io.h> o <wchar.h> |
_wfindnext32 |
<io.h> o <wchar.h> |
_wfindnext64 |
<io.h> o <wchar.h> |
_wfindnexti64 |
<io.h> o <wchar.h> |
_wfindnext32i64 |
<io.h> o <wchar.h> |
_wfindnext64i32 |
<io.h> o <wchar.h> |
Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.
bibliotecas
todas las versiones de Bibliotecas en tiempo de ejecución de C.
Equivalente en .NET Framework
No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.