Fungsi FindNextFileA (fileapi.h)

Artikel
08/23/2023

Melanjutkan pencarian file dari panggilan sebelumnya ke fungsi FindFirstFile, FindFirstFileEx, atau FindFirstFileTransacted .

Sintaks

BOOL FindNextFileA(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAA lpFindFileData
);

Parameter

[in] hFindFile

Handel pencarian yang dikembalikan oleh panggilan sebelumnya ke fungsi FindFirstFile atau FindFirstFileEx .

[out] lpFindFileData

Penunjuk ke struktur WIN32_FIND_DATA yang menerima informasi tentang file atau subdirektori yang ditemukan.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol dan parameter lpFindFileData berisi informasi tentang file atau direktori berikutnya yang ditemukan.

Jika fungsi gagal, nilai yang dikembalikan adalah nol dan konten lpFindFileData tidak ditentukan. Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Jika fungsi gagal karena tidak ada lagi file yang cocok yang dapat ditemukan, fungsi GetLastError mengembalikan ERROR_NO_MORE_FILES.

Keterangan

Fungsi ini menggunakan filter pencarian yang sama yang digunakan untuk membuat handel pencarian yang diteruskan dalam parameter hFindFile . Untuk informasi tambahan, lihat FindFirstFile dan FindFirstFileEx.

Urutan di mana pencarian mengembalikan file, seperti urutan alfabet, tidak dijamin, dan tergantung pada sistem file. Jika data harus diurutkan, aplikasi harus melakukan pemesanan setelah mendapatkan semua hasilnya.

Catatan Dalam kasus yang jarang terjadi atau pada sistem yang sangat dimuat, informasi atribut file pada sistem file NTFS mungkin tidak terkini pada saat fungsi ini dipanggil. Untuk memastikan mendapatkan atribut file sistem file NTFS saat ini, panggil fungsi GetFileInformationByHandle .

Urutan di mana fungsi ini mengembalikan nama file tergantung pada jenis sistem file. Dengan sistem file NTFS dan sistem file CDFS, nama biasanya dikembalikan dalam urutan alfabet. Dengan sistem file FAT, nama biasanya dikembalikan dalam urutan file ditulis ke disk, yang mungkin atau mungkin tidak dalam urutan alfabet. Namun, seperti yang dinyatakan sebelumnya, perilaku ini tidak dijamin.

Jika jalur menunjuk ke tautan simbolis, buffer WIN32_FIND_DATA berisi informasi tentang tautan simbolis, bukan target.

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Ya
SMB 3.0 Transparent Failover (TFO)	Ya
SMB 3.0 dengan Berbagi File Peluasan Skala (SO)	Ya
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

Operasi Yang Ditransaksikan

Jika ada transaksi yang terikat ke handel enumerasi file, maka file yang dikembalikan tunduk pada aturan isolasi transaksi.

Contoh

Misalnya, lihat Mencantumkan File dalam Direktori.

Catatan

Header fileapi.h mendefinisikan FindNextFile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	fileapi.h (sertakan Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll