_findnext _wfindnext

Článek
03/04/2013

Najít další název, pokud existuje, který odpovídá filespec argument v předchozí volání k _findfirsta poté změňte fileinfo struktury obsah odpovídajícím způsobem.

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í volání k _findfirst.
fileinfo
Vyrovnávací paměť informace souboru.

Vrácená hodnota

V případě úspěchu vrátí 0.V ostatních případech vrátí hodnotu –1 a nastaví errno na hodnotu určující povahu chyby.V následující tabulce jsou uvedeny možné chybové kódy.

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

Pokud je předán neplatný parametr, tyto funkce vyvolat popisovač neplatný parametr popsaným v Ověření parametrů.

Poznámky

Musíte zavolat _findclose po použití buď _findfirst nebo _findnext funkci (nebo všechny varianty).Tím se uvolní prostředky používané tyto funkce v aplikaci.

Variace těchto funkcí se w předpona jsou verze wide znak; jinak jsou totožné s odpovídající funkce jednoho bajtu.

Variace těchto funkcí podporují 32bitové nebo 64bitové čas typy a velikosti souboru 32 nebo 64-bit.První číselnou příponu (32 nebo 64) označuje velikost typ času používat; druhý přípona je buď i32 nebo i64, označující zda velikost souboru je vyjádřen 32bitové nebo 64bitové celé číslo.Informace o tom, které verze podporují 32bitové a 64bitové čas typy a velikosti souboru naleznete v následující tabulce.Povolit odchylky, které čas 64bitový typ Datum vytvoření souboru vyjádřeno pomocí 23: 59: 59, do 31. prosince 3000 UTC; vzhledem k tomu, že jsou pouze typy 32bitové čas pomocí představují data prostřednictvím 19: 14: 07 18 01.01.08, UTC.Půlnoc, 1. ledna 1970 je dolní mez rozsahu data pro tyto funkce.

Pokud nemáte zvláštní důvod použití verze, které explicitně zadat čas velikost, použijte _findnext nebo _wfindnext nebo potřebujete podporu velikost souboru je větší než 3 GB, použijte _findnexti64 nebo _wfindnexti64.Tyto funkce použít typ času 64 bit.V předchozích verzích tyto funkce používají typ 32bitové čas.Pokud změnu rozdělení aplikace může definovat _USE_32BIT_TIME_T získat staré chování.Pokud _USE_32BIT_TIME_T je definován _findnext, _finnexti64 a jejich odpovídající verze Unicode používají 32bitové čas.

Typ času a typu Variant délky souboru _findnext

Funkce	_USE_32BIT_TIME_Tdefinice?	Typ času	Délka typu souboru
_findnext, _wfindnext	Není definován	64bitová verze	32bitová verze
_findnext, _wfindnext	Definice	32bitová verze	32bitová verze
_findnext32, _wfindnext32	Nemá vliv na definici makra	32bitová verze	32bitová verze
_findnext64, _wfindnext64	Nemá vliv na definici makra	64bitová verze	64bitová verze
_findnexti64, _wfindnexti64	Není definován	64bitová verze	64bitová verze
_findnexti64, _wfindnexti64	Definice	32bitová verze	64bitová verze
_findnext32i64, _wfindnext32i64	Nemá vliv na definici makra	32bitová verze	64bitová verze
_findnext64i32, _wfindnext64i32	Nemá vliv na definici makra	64bitová verze	32bitová verze

Obecný Text rutinní mapování

Rutina Tchar.h	_UNICODE a _MBCS není definován	_MBCS, definice	_UNICODE, definice
_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é záhlaví
_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ě v tématu Compatibility v úvodu.

Knihovny

Všechny verze C Runtime knihovny.

Ekvivalent v rozhraní .NET Framework

Nelze použít Použijte volání funkce standardní C, PInvoke. Další informace naleznete v tématu Příklady vyvolat platformu.

Viz také

Referenční dokumentace

Systémová volání

_find funkce _wfind

Sdílet prostřednictvím