Fungsi FindNextVolumeA (winbase.h)
Melanjutkan pencarian volume yang dimulai oleh panggilan ke fungsi FindFirstVolume . FindNextVolume menemukan satu volume per panggilan.
Sintaks
BOOL FindNextVolumeA(
[in] HANDLE hFindVolume,
[out] LPSTR 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.
Mengembalikan 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 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 Scale-out File Shares (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 | winbase.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |