_findnext, _wfindnext

Artículo
02/19/2013

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.

Vea también

Referencia

Llamadas del sistema

_find, funciones de _wfind

Compartir a través de