Fungsi FindNextVolumeMountPointA (winbase.h)
Melanjutkan pencarian folder yang dipasang dimulai dengan panggilan ke fungsi FindFirstVolumeMountPoint . FindNextVolumeMountPoint menemukan satu folder yang dipasang per panggilan.
Sintaks
BOOL FindNextVolumeMountPointA(
[in] HANDLE hFindVolumeMountPoint,
[out] LPSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parameter
[in] hFindVolumeMountPoint
Handel pencarian folder yang dipasang dikembalikan oleh panggilan sebelumnya ke fungsi FindFirstVolumeMountPoint .
[out] lpszVolumeMountPoint
Penunjuk ke buffer yang menerima nama folder terpasang yang ditemukan.
[in] cchBufferLength
Panjang buffer yang menerima nama folder yang dipasang, di TCHAR.
Nilai kembali
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 lagi folder yang dipasang yang dapat ditemukan, fungsi GetLastError mengembalikan kode kesalahan ERROR_NO_MORE_FILES . Dalam hal ini, tutup pencarian dengan fungsi FindVolumeMountPointClose .
Keterangan
Setelah handel pencarian dibuat dengan memanggil FindFirstVolumeMountPoint, Anda dapat menggunakan fungsi FindNextVolumeMountPoint untuk mencari folder lain yang dipasang.
Fungsi FindFirstVolumeMountPoint, FindNextVolumeMountPoint, dan FindVolumeMountPointClose mengembalikan jalur ke folder yang dipasang untuk volume tertentu. Mereka tidak mengembalikan huruf kandar atau jalur GUID volume. Untuk informasi tentang menghitung jalur GUID volume untuk volume, lihat Menghitung Jalur GUID Volume.
Anda tidak boleh mengasumsikan korelasi apa pun antara urutan folder yang dipasang yang dikembalikan dengan fungsi-fungsi ini dan urutan folder yang dipasang yang dikembalikan oleh fungsi atau alat lain.
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) | Tidak |
| Sistem File Tangguh (ReFS) | Tidak |
SMB tidak mendukung fungsi manajemen volume. CsvFS tidak mendukung penambahan titik pemasangan pada volume CSV. ReFS tidak mengindeks titik pemasangan.
Catatan
Header winbase.h mendefinisikan FindNextVolumeMountPoint sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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 [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 |