_findnext, _findnext32, _findnext32i64, _findnext64, _findnext64i32, _findnexti64, _wfindnext, _wfindnext32, _wfindnext32i64, _wfindnext64, _wfindnext64i32, _wfindnexti64

Najděte další název, pokud existuje, který odpovídá argumentu filespec v předchozím volání _findfirst, a pak odpovídajícím způsobem změnit fileinfo obsah struktury.

Syntaxe

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

Parametry

handle
Popisovač hledání vrácený předchozím voláním _findfirst.

fileinfo
Vyrovnávací paměť informací o souboru.

Vrácená hodnota

V případě úspěchu vrátí hodnotu 0. V opačném případě vrátí hodnotu -1 a nastaví errno hodnotu označující povahu selhání. Možné kódy chyb jsou uvedeny v následující tabulce.

errno Hodnotu	Podmínka
EINVAL	Neplatný parametr: fileinfo byl NULL. Nebo operační systém vrátil neočekávanou chybu.
ENOENT	Nebyly nalezeny žádné odpovídající soubory.
ENOMEM	Nedostatek paměti nebo délka názvu souboru byla překročena MAX_PATH.

Pokud je předán neplatný parametr, tyto funkce vyvolat neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru.

Poznámky

Po dokončení je nutné volat _findclose buď pomocí _findfirst funkce, nebo _findnext funkce (nebo jakékoli varianty). _findclose uvolní prostředky používané těmito funkcemi ve vaší aplikaci.

Varianty těchto funkcí s předponou w jsou širokoznační verze. V opačném případě jsou identické s odpovídajícími jednobajtů funkcemi.

Varianty těchto funkcí podporují 32bitové nebo 64bitové typy a 32bitové nebo 64bitové velikosti souborů. První číselná přípona (32 nebo 64) označuje velikost použitého časového typu; druhá přípona je buď i32 nebo i64, označující, zda je velikost souboru reprezentována jako 32bitové nebo 64bitové celé číslo. Informace o tom, které verze podporují 32bitové a 64bitové typy a velikosti souborů, najdete v následující tabulce. Varianty, které používají 64bitový typ času, umožňují vyjádřit data vytvoření souboru do 23:59:59, 31. prosince 3000 UTC; Zatímco ty, které používají 32bitové časové typy, představují kalendářní data pouze do 23:59:59 18, 2038 UTC. Půlnoc, leden 1, 1970, je dolní mez rozsahu dat pro všechny tyto funkce.

Pokud nemáte konkrétní důvod použití verzí, které určují velikost času explicitně, použijte _findnext nebo _wfindnext , pokud potřebujete podporovat velikosti souborů větší než 3 GB, použijte _findnexti64 nebo _wfindnexti64. Všechny tyto funkce používají 64bitový typ času. V předchozích verzích tyto funkce používaly 32bitový typ času. Pokud se jedná o zásadní změnu aplikace, můžete definovat _USE_32BIT_TIME_T , že chcete získat staré chování. Pokud _USE_32BIT_TIME_T je definována, _findnexti64_findnexta jejich odpovídající verze Unicode používají 32bitový čas.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Varianty typu časového typu a délky souboru _findnext

Funkce	_USE_32BIT_TIME_T Definovány?	Typ času	Typ délky souboru
_findnext, _wfindnext	Nedefinováno	64bitová	32bitová
_findnext, _wfindnext	Definované	32bitová	32bitová
_findnext32, _wfindnext32	Není ovlivněn definicí makra.	32bitová	32bitová
_findnext64, _wfindnext64	Není ovlivněn definicí makra.	64bitová	64bitová
_findnexti64, _wfindnexti64	Nedefinováno	64bitová	64bitová
_findnexti64, _wfindnexti64	Definované	32bitová	64bitová
_findnext32i64, _wfindnext32i64	Není ovlivněn definicí makra.	32bitová	64bitová
_findnext64i32, _wfindnext64i32	Není ovlivněn definicí makra.	64bitová	32bitová

Mapování rutin obecného textu

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS Definovány	_UNICODE Definovány
_tfindnext	_findnext	_findnext	_wfindnext
_tfindnext32	_findnext32	_findnext32	_wfindnext32
_tfindnext64	_findnext64	_findnext64	_wfindnext64
_tfindnexti64	_findnexti64	_findnexti64	_wfindnexti64
_tfindnext32i64	_findnext32i64	_findnext32i64	_wfindnext32i64
_tfindnext64i32	_findnext64i32	_findnext64i32	_wfindnext64i32

Požadavky

Function	Požadovaný hlavičkový soubor
_findnext	<io.h>
_findnext32	<io.h>
_findnext64	<io.h>
_findnexti64	<io.h>
_findnext32i64	<io.h>
_findnext64i32	<io.h>
_wfindnext	<io.h> nebo <wchar.h>
_wfindnext32	<io.h> nebo <wchar.h>
_wfindnext64	<io.h> nebo <wchar.h>
_wfindnexti64	<io.h> nebo <wchar.h>
_wfindnext32i64	<io.h> nebo <wchar.h>
_wfindnext64i32	<io.h> nebo <wchar.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Knihovny

Všechny verze knihoven runtime jazyka C.

Viz také

Systémová volání
Funkce hledání názvů souborů