_findnext, , _findnext32i64_findnext32, _findnext64, _findnext64i32, _findnexti64, _wfindnext, _wfindnext32, _wfindnext32i64, , _wfindnext64, , _wfindnext64i32_wfindnexti64

Temukan nama berikutnya, jika ada, yang cocok dengan filespec argumen dalam panggilan sebelumnya ke _findfirst, lalu ubah fileinfo konten struktur yang sesuai.

Sintaks

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

Parameter

handle
Handel pencarian dikembalikan oleh panggilan sebelumnya ke _findfirst.

fileinfo
Buffer informasi file.

Nilai hasil

Jika berhasil, mengembalikan 0. Jika tidak, mengembalikan -1 dan mengatur errno ke nilai yang menunjukkan sifat kegagalan. Kemungkinan kode kesalahan ditampilkan dalam tabel berikut.

errno nilai	Kondisi
EINVAL	Parameter tidak valid: fileinfo adalah NULL. Atau, sistem operasi mengembalikan kesalahan tak terduga.
ENOENT	Tidak ada lagi berkas yang cocok yang dapat ditemukan.
ENOMEM	Tidak cukup memori atau panjang nama file melebihi MAX_PATH.

Jika parameter yang tidak valid diteruskan, fungsi-fungsi ini memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter.

Keterangan

Anda harus memanggil _findclose setelah selesai menggunakan _findfirst fungsi atau _findnext (atau varian apa pun). _findclose membebaskan sumber daya yang digunakan oleh fungsi-fungsi ini dalam aplikasi Anda.

Variasi fungsi-fungsi ini dengan awalan w adalah versi karakter lebar; jika tidak, fungsi tersebut identik dengan fungsi byte tunggal yang sesuai.

Variasi fungsi ini mendukung jenis waktu 32-bit atau 64-bit dan ukuran file 32-bit atau 64-bit. Akhiran numerik pertama (32 atau 64) menunjukkan ukuran jenis waktu yang digunakan; akhiran kedua adalah i32 atau i64, yang menunjukkan apakah ukuran file diwakili sebagai bilangan bulat 32-bit atau 64-bit. Untuk informasi tentang versi mana yang mendukung jenis waktu dan ukuran file 32-bit dan 64-bit, lihat tabel berikut ini. Variasi yang menggunakan jenis waktu 64-bit memungkinkan tanggal pembuatan file diekspresikan hingga 23:59:59, 31 Desember 3000, UTC; sedangkan yang menggunakan jenis waktu 32-bit hanya mewakili tanggal hingga 23:59:59 18 Januari 2038, UTC. Tengah malam, 1 Januari 1970, adalah batas bawah rentang tanggal untuk semua fungsi ini.

Kecuali Anda memiliki alasan khusus untuk menggunakan versi yang menentukan ukuran waktu secara eksplisit, gunakan _findnext atau _wfindnext atau, jika Anda perlu mendukung ukuran file yang lebih besar dari 3 GB, gunakan _findnexti64 atau _wfindnexti64. Semua fungsi ini menggunakan jenis waktu 64-bit. Dalam versi sebelumnya, fungsi-fungsi ini menggunakan jenis waktu 32-bit. Jika perubahan ini adalah perubahan yang melanggar untuk aplikasi, Anda mungkin menentukan _USE_32BIT_TIME_T untuk mendapatkan perilaku lama. Jika _USE_32BIT_TIME_T didefinisikan, _findnext, _findnexti64 dan versi Unicode yang sesuai menggunakan waktu 32-bit.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Jenis Waktu dan Variasi Tipe Panjang File _findnext

Fungsi	_USE_32BIT_TIME_T Didefinisikan?	Jenis waktu	Jenis panjang file
_findnext, _wfindnext	Tidak ditentukan	64-bit	32-bit
_findnext, _wfindnext	Didefinisikan	32-bit	32-bit
_findnext32, _wfindnext32	Tidak terpengaruh oleh definisi makro	32-bit	32-bit
_findnext64, _wfindnext64	Tidak terpengaruh oleh definisi makro	64-bit	64-bit
_findnexti64, _wfindnexti64	Tidak ditentukan	64-bit	64-bit
_findnexti64, _wfindnexti64	Didefinisikan	32-bit	64-bit
_findnext32i64, _wfindnext32i64	Tidak terpengaruh oleh definisi makro	32-bit	64-bit
_findnext64i32, _wfindnext64i32	Tidak terpengaruh oleh definisi makro	64-bit	32-bit

Pemetaan rutin teks generik

Rutinitas Tchar.h	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tfindnext	_findnext	_findnext	_wfindnext
_tfindnext32	_findnext32	_findnext32	_wfindnext32
_tfindnext64	_findnext64	_findnext64	_wfindnext64
_tfindnexti64	_findnexti64	_findnexti64	_wfindnexti64
_tfindnext32i64	_findnext32i64	_findnext32i64	_wfindnext32i64
_tfindnext64i32	_findnext64i32	_findnext64i32	_wfindnext64i32

Persyaratan

Fungsi	Header yang diperlukan
_findnext	<io.h>
_findnext32	<io.h>
_findnext64	<io.h>
_findnexti64	<io.h>
_findnext32i64	<io.h>
_findnext64i32	<io.h>
_wfindnext	<io.h> atau <wchar.h>
_wfindnext32	<io.h> atau <wchar.h>
_wfindnext64	<io.h> atau <wchar.h>
_wfindnexti64	<io.h> atau <wchar.h>
_wfindnext32i64	<io.h> atau <wchar.h>
_wfindnext64i32	<io.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Lihat juga

Panggilan sistem
Fungsi pencarian nama file