Fungsi GetVolumeNameForVolumeMountPointW (fileapi.h)

  • Artikel

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

Lihat juga

DeleteVolumeMountPoint

GetVolumePathName

Folder Terpasang

SetVolumeMountPoint

Fungsi Manajemen Volume