_findfirst, _wfindfirst

Článek
06/09/2015

Informace o první instanci název odpovídající soubor zadaný v souboru filespec argument.

intptr_t _findfirst(
   const char *filespec,
   struct _finddata_t *fileinfo 
);
intptr_t _findfirst32(
   const char *filespec,
   struct _finddata32_t *fileinfo 
);
intptr_t _findfirst64(
   const char *filespec,
   struct _finddata64_t *fileinfo 
);
intptr_t _findfirsti64(
   const char *filespec,
   struct _finddatai64_t *fileinfo 
);
intptr_t _findfirst32i64(
   const char *filespec,
   struct _finddata32i64_t *fileinfo 
);
intptr_t _findfirst64i32(
   const char *filespec,
   struct _finddata64i32_t *fileinfo 
);
intptr_t _wfindfirst(
   const wchar_t *filespec,
   struct _wfinddata_t *fileinfo 
);
intptr_t _wfindfirst32(
   const wchar_t *filespec,
   struct _wfinddata32_t *fileinfo 
);
intptr_t _wfindfirst64(
   const wchar_t *filespec,
   struct _wfinddata64_t *fileinfo 
);
intptr_t _wfindfirsti64(
   const wchar_t *filespec,
   struct _wfinddatai64_t *fileinfo 
);
intptr_t _wfindfirst32i64(
   const wchar_t *filespec,
   struct _wfinddata32i64_t *fileinfo 
);
intptr_t _wfindfirst64i32(
   const wchar_t *filespec,
   struct _wfinddata64i32_t *fileinfo 
);

Parametry

filespec
Specifikace souboru cíl (můžete použít zástupné znaky).
fileinfo
Vyrovnávací paměť informace souboru.

Vrácená hodnota

Pokud je úspěšná, _findfirst vrátí popisovač jedinečné hledání identifikující soubor nebo skupinu souborů, které odpovídají filespec specifikace, které lze použít následující volání _findnext nebo _findclose.Jinak _findfirst vrátí hodnotu –1 a nastaví errno na jednu z následujících hodnot.

EINVAL
Invalid parameter: filespec or fileinfo was NULL.Nebo operační systém vrátil neočekávanou chybu.
ENOENT
Specifikace souboru, který se neshoduje.
ENOMEM
Není dostatek paměti.
EINVAL
Název specifikace souboru je neplatná nebo název souboru byla větší než MAX_PATH.

Další informace o těchto a jiných návratové kódy, viz _doserrno, kód chyby, _sys_errlist a _sys_nerr.

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

Poznámky

Musíte zavolat _findclose po dokončení 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í, které mají 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í číselná přípona (32 nebo 64) označuje velikost typ času; druhý přípona je buď i32 nebo i64a označuje, zda velikost souboru je reprezentován jako 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.i32 Nebo i64 příponu vynecháte, pokud je stejná jako velikost typ času tak _findfirst64 podporuje také 64bitový soubor délek a _findfirst32 podporuje pouze 32bitový soubor délky.

Tyto funkce používají různé formy _finddata_t strukturu fileinfo parametr.Další informace o struktuře _find, _wfind – funkce.

Odchylky, které čas 64bitový typ povolit datum vytvoření souboru vyjádřeno pomocí 23: 59: 59, do 31. prosince 3000 UTC.Ty, které čas 32bitové typy představují data pouze 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 _findfirst nebo _wfindfirst nebo potřebujete podporu velikost souboru je větší než 3 GB, použijte _findfirsti64 nebo _wfindfirsti64.Tyto funkce použít typ času 64 bit.V dřívějších verzích tyto funkce používají typ 32bitové čas.Pokud změnu rozdělení aplikace může definovat _USE_32BIT_TIME_T obnovit staré chování.Pokud _USE_32BIT_TIME_T je definován _findfirst, _finfirsti64, a jejich odpovídající verze Unicode používají 32bitové čas.

Typ času a typu Variant délky souboru _findfirst

Funkce	_USE_32BIT_TIME_Tdefinice?	Typ času	Délka typu souboru
_findfirst, _wfindfirst	Není definován	64bitová verze	32bitová verze
_findfirst, _wfindfirst	Definice	32bitová verze	32bitová verze
_findfirst32, _wfindfirst32	Nemá vliv na definici makra	32bitová verze	32bitová verze
_findfirst64, _wfindfirst64	Nemá vliv na definici makra	64bitová verze	64bitová verze
_findfirsti64, _wfindfirsti64	Není definován	64bitová verze	64bitová verze
_findfirsti64, _wfindfirsti64	Definice	32bitová verze	64bitová verze
_findfirst32i64, _wfindfirst32i64	Nemá vliv na definici makra	32bitová verze	64bitová verze
_findfirst64i32, _wfindfirst64i32	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
_tfindfirst	_findfirst	_findfirst	_wfindfirst
_tfindfirst32	_findfirst32	_findfirst32	_wfindfirst32
_tfindfirst64	_findfirst64	_findfirst64	_wfindfirst64
_tfindfirsti64	_findfirsti64	_findfirsti64	_wfindfirsti64
_tfindfirst32i64	_findfirst32i64	_findfirst32i64	_wfindfirst32i64
_tfindfirst64i32	_findfirst64i32	_findfirst64i32	_wfindfirst64i32

Požadavky

Function	Požadované záhlaví
_findfirst	<io.h>
_findfirst32	<io.h>
_findfirst64	<io.h>
_findfirsti64	<io.h>
_findfirst32i64	<io.h>
_findfirst64i32	<io.h>
_wfindfirst	<io.h> nebo <wchar.h>
_wfindfirst32	<io.h> nebo <wchar.h>
_wfindfirst64	<io.h> nebo <wchar.h>
_wfindfirsti64	<io.h> nebo <wchar.h>
_wfindfirst32i64	<io.h> nebo <wchar.h>
_wfindfirst64i32	<io.h> nebo <wchar.h>