_findfirst, _wfindfirst

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

Genel metin yordamı eşlemeleri

Gereksinimler

Daha fazla uyumluluk bilgileri için bkz: Uyumluluk giriş.

.NET Framework Eşdeğeri

System::IO::DirectoryInfo::GetFiles

Ayrıca bkz.

Başvuru

Sistem Çağrıları

_find, _wfind İşlevleri