Fungsi FindNextVolumeMountPointA (winbase.h)

  • Artikel

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

Lihat juga

FindFirstVolumeMountPoint

FindVolumeMountPointClose

Folder Terpasang

Fungsi Manajemen Volume