Fungsi FindNextFileW (fileapi.h)

Artikel
20/11/2024

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

Sintaksis

BOOL FindNextFileW(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAW lpFindFileData
);

Parameter

[in] hFindFile

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

[out] lpFindFileData

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

Mengembalikan nilai

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

Jika fungsi gagal, nilai pengembalian 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.

Komentar

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
Failover Transparan (TFO) SMB 3.0	Ya
SMB 3.0 dengan Scale-out File Shares (SO)	Ya
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

Operasi Ditransaksikan

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

Contoh

Misalnya, lihat Mencantumkan File di 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

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

Lihat juga

File Management Functions

FindClose

FindFirstFile

FindFirstFileEx

GetFileAttributes

SetFileAttributes

Tautan Simbolis

WIN32_FIND_DATA

Bagikan melalui