Fungsi FindFirstVolumeMountPointA (winbase.h)

Artikel
08/27/2023

Mengambil nama folder yang dipasang pada volume yang ditentukan. FindFirstVolumeMountPoint digunakan untuk mulai memindai folder yang dipasang pada volume.

Sintaks

HANDLE FindFirstVolumeMountPointA(
  [in]  LPCSTR lpszRootPathName,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

Parameter

[in] lpszRootPathName

Jalur GUID volume untuk volume yang akan dipindai untuk folder yang dipasang. Garis miring terbelakang diperlukan.

[out] lpszVolumeMountPoint

Penunjuk ke buffer yang menerima nama folder pertama yang dipasang yang ditemukan.

[in] cchBufferLength

Panjang buffer yang menerima jalur ke folder yang dipasang, di TCHARs.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah handel pencarian yang digunakan dalam panggilan berikutnya ke fungsi FindNextVolumeMountPoint dan FindVolumeMountPointClose .

Jika fungsi gagal menemukan folder yang dipasang pada volume, nilai yang dikembalikan adalah kode kesalahan INVALID_HANDLE_VALUE . Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi FindFirstVolumeMountPoint membuka handel pencarian folder yang dipasang dan mengembalikan informasi tentang folder pertama yang dipasang yang ditemukan pada volume yang ditentukan. Setelah handel pencarian dibuat, Anda dapat menggunakan fungsi FindNextVolumeMountPoint untuk mencari folder lain yang dipasang. Ketika handel pencarian tidak lagi diperlukan, tutup dengan fungsi FindVolumeMountPointClose .

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 oleh 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 FindFirstVolumeMountPoint sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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


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

FindNextVolumeMountPoint

FindVolumeMountPointClose

Folder Terpasang

Fungsi Manajemen Volume