_findfirst, _wfindfirst

Makale
06/09/2015

Bir dosya adı belirtilen dosyayla eşleşen ilk örneği hakkında bilgi sağlamak filespec bağımsız değişkeni.

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

Parametreler

filespec
Hedef dosya belirtimi (joker karakter içerebilir).
fileinfo
Dosya bilgisi arabelleği.

Dönüş Değeri

Başarılı olursa, _findfirst dosyası veya eşleşen dosya grubunu tanımlayan benzersiz arama tanıtıcısı döndürür filespec sonraki çağrısında kullanılan belirtimi _findnext veya _findclose.Aksi halde, _findfirst –1 değerini döndürür ve ayarlar errno aşağıdaki değerlerden birini.

EINVAL
Invalid parameter: filespec or fileinfo was NULL.Ya da işletim sistemi beklenmeyen bir hata döndürdü.
ENOENT
Dosya belirtimi değil eşleştirilebilir.
ENOMEM
Bellek yetersiz.
EINVAL
Geçersiz dosya adı belirtimi veya dosya adı verilen büyük MAX_PATH.

Bunlar ve diğer dönüş kodları hakkında daha fazla bilgi için bkz: _doserrno, errno, _sys_errlist ve _sys_nerr.

Geçersiz bir parametre olarak geçirilir, bu işlevler geçersiz parametre işleyicisi açıklandığı şekilde harekete Parametre Doğrulama.

Notlar

Çağırması gerekir _findclose ile ya da bitmiş sonra _findfirst veya _findnext işlevi (veya tüm çeşitleri).Bu, bu işlevleri, uygulamanız tarafından kullanılan kaynakları serbest bırakır.

Bu işlevleri çeşitlerini w öneki olan geniş karakter sürümleri; Aksi halde, bunlar ilgili tek baytlık işlevlerle birbirinin aynıdır.

Bu işlevler çeşitlerini 32-bit veya 64-bit saat türleri ve 32-bit veya 64-bit dosya boyutlarını destekler.İlk sayısal sonek (32 veya 64); saat türü boyutunu gösterir İkinci soneki olması i32 veya i64ve dosya boyutu 32-bit veya 64-bit bir tamsayı olarak temsil edilir gösterir.Sürümleri 32-bit ve 64-bit saat türleri ve dosya boyutlarını destekleyen hakkında daha fazla bilgi için aşağıdaki tabloya bakın.i32 Veya i64 bu nedenle zaman yazı tipi boyutu ile aynı ise, sonek göz ardı _findfirst64 de 64-bit dosya uzunluklarını destekler ve _findfirst32 yalnızca 32-bit dosya uzunluklarını destekler.

Bu işlevleri, çeşitli formları kullanma _finddata_t için yapı fileinfo parametresi.Yapısı hakkında daha fazla bilgi için bkz: _find, _wfind İşlevleri.

23: 59: 59 İle 31 Aralık 3000 utc yukarı ifade dosya oluşturma tarihlerinin bir 64-bit süre türünü kullanan çeşitlemeleri etkinleştirin.32-Bit zaman türleri kullanan olanlar yalnızca aracılığıyla 19: 14: 07 18 Ocak 2038 utc Tarih temsil eder.Gece yarısı, 1 Ocak 1970, bu işlevler için tarih aralığı alt sınırdır.

Zaman boyutunun açıkça belirtin, kullanın sürümlerini kullanmak için özel bir nedeniniz yoksa _findfirst veya _wfindfirst veya 3 GB'tan daha büyük dosya boyutları desteklemek gereksinim duyarsanız kullanın _findfirsti64 veya _wfindfirsti64.Bu işlevler 64-bit süre türünü kullanın.Önceki sürümlerde, bu işlevler bir 32-bit saat türü kullanılır.Bu uygulamanın son değişiklik, tanımlayabilir _USE_32BIT_TIME_T eski davranışına dönmek için._USE_32BIT_TIME_T Tanımlanır, _findfirst, _finfirsti64, ve 32-bit zaman karşılık gelen Unicode sürümlerini kullanın.

Saat türü ve dosya uzunluğu türü _findfirst çeşidi

İşlevler	_USE_32BIT_TIME_Ttanımlanan?	Saat türü	Dosya uzunluğu türü
_findfirst, _wfindfirst	Tanımlı değil	64 bit	32 bit
_findfirst, _wfindfirst	Tanımlanmış	32 bit	32 bit
_findfirst32, _wfindfirst32	Makro tanımına göre etkilenmez	32 bit	32 bit
_findfirst64, _wfindfirst64	Makro tanımına göre etkilenmez	64 bit	64 bit
_findfirsti64, _wfindfirsti64	Tanımlı değil	64 bit	64 bit
_findfirsti64, _wfindfirsti64	Tanımlanmış	32 bit	64 bit
_findfirst32i64, _wfindfirst32i64	Makro tanımına göre etkilenmez	32 bit	64 bit
_findfirst64i32, _wfindfirst64i32	Makro tanımına göre etkilenmez	64 bit	32 bit

Genel metin yordamı eşlemeleri

Tchar.h yordamına girildi	_UNICODE ve _mbcs tanımlı değil	Tanımlanan _mbcs	Tanımlanan _UNICODE
_tfindfirst	_findfirst	_findfirst	_wfindfirst
_tfindfirst32	_findfirst32	_findfirst32	_wfindfirst32
_tfindfirst64	_findfirst64	_findfirst64	_wfindfirst64
_tfindfirsti64	_findfirsti64	_findfirsti64	_wfindfirsti64
_tfindfirst32i64	_findfirst32i64	_findfirst32i64	_wfindfirst32i64
_tfindfirst64i32	_findfirst64i32	_findfirst64i32	_wfindfirst64i32

Gereksinimler

İşlev	Gerekli başlık
_findfirst	<io.h>
_findfirst32	<io.h>
_findfirst64	<io.h>
_findfirsti64	<io.h>
_findfirst32i64	<io.h>
_findfirst64i32	<io.h>
_wfindfirst	<io.h> veya <wchar.h>
_wfindfirst32	<io.h> veya <wchar.h>
_wfindfirst64	<io.h> veya <wchar.h>
_wfindfirsti64	<io.h> veya <wchar.h>
_wfindfirst32i64	<io.h> veya <wchar.h>
_wfindfirst64i32	<io.h> veya <wchar.h>