Fungsi GetVolumeNameForVolumeMountPointW (fileapi.h)
Mengambil jalur GUID volume untuk volume yang terkait dengan titik pemasangan volume yang ditentukan ( huruf drive, jalur GUID volume, atau folder yang dipasang).
Sintaks
BOOL GetVolumeNameForVolumeMountPointW(
[in] LPCWSTR lpszVolumeMountPoint,
[out] LPWSTR lpszVolumeName,
[in] DWORD cchBufferLength
);
Parameter
[in] lpszVolumeMountPoint
Penunjuk ke string yang berisi jalur folder yang dipasang (misalnya, "Y:\MountX\") atau huruf drive (misalnya, "X:\"). String harus diakhir dengan garis miring terbelakang ('\').
[out] lpszVolumeName
Penunjuk ke string yang menerima jalur GUID volume. Jalur ini berbentuk "\\?\Volume{GUID}\" di mana GUID adalah GUID yang mengidentifikasi volume. Jika ada lebih dari satu jalur GUID volume untuk volume, hanya yang pertama di cache manajer pemasangan yang dikembalikan.
[in] cchBufferLength
Panjang buffer output, dalam TCHAR. Ukuran yang wajar bagi buffer untuk mengakomodasi jalur GUID volume terbesar yang mungkin adalah 50 karakter.
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.
Keterangan
Gunakan GetVolumeNameForVolumeMountPoint untuk mendapatkan jalur GUID volume untuk digunakan dengan fungsi seperti SetVolumeMountPoint dan FindFirstVolumeMountPoint yang memerlukan jalur GUID volume sebagai parameter input. Untuk informasi selengkapnya tentang jalur GUID volume, lihat Penamaan Volume.
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) | Tidak |
SMB tidak mendukung fungsi manajemen volume.
Titik pemasangan tidak didukung oleh volume ReFS.
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 |