Fungsi FindNextVolumeW (fileapi.h)

  • Artikel

Melanjutkan pencarian volume yang dimulai oleh panggilan ke fungsi FindFirstVolume . FindNextVolume menemukan satu volume per panggilan.

Sintaks

BOOL FindNextVolumeW(
  [in]  HANDLE hFindVolume,
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

Parameter

[in] hFindVolume

Handel pencarian volume yang dikembalikan oleh panggilan sebelumnya ke fungsi FindFirstVolume .

[out] lpszVolumeName

Penunjuk ke string yang menerima jalur GUID volume yang ditemukan.

[in] cchBufferLength

Panjang buffer yang menerima jalur GUID volume, di TCHAR.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Jika tidak ada file yang cocok yang dapat ditemukan, fungsi GetLastError mengembalikan kode kesalahan ERROR_NO_MORE_FILES . Dalam hal ini, tutup pencarian dengan fungsi FindVolumeClose .

Keterangan

Setelah handel pencarian dibuat dengan memanggil FindFirstVolume, Anda dapat menggunakan fungsi FindNextVolume untuk mencari volume lain.

Anda tidak boleh mengasumsikan korelasi apa pun antara urutan volume yang dikembalikan oleh fungsi-fungsi ini dan urutan volume yang ada di komputer. Secara khusus, jangan asumsikan korelasi antara urutan volume dan huruf drive seperti yang ditetapkan oleh BIOS (jika ada) atau Administrator Disk.

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

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

SMB tidak mendukung fungsi manajemen volume.

Contoh

Misalnya, lihat Menampilkan Jalur Volume.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header fileapi.h (sertakan Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

FindFirstVolume

FindVolumeClose

Folder Terpasang

Fungsi Manajemen Volume