Fungsi GetVolumePathNamesForVolumeNameW (fileapi.h)

  • Artikel

Mengambil daftar huruf kandar dan jalur folder yang dipasang untuk volume yang ditentukan.

Sintaks

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

Parameter

[in] lpszVolumeName

Jalur GUID volume untuk volume. Jalur GUID volume berbentuk "\\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxx}\".

[out] lpszVolumePathNames

Penunjuk ke buffer yang menerima daftar huruf kandar dan jalur folder yang dipasang. Daftar ini adalah array string null-terminated yang dihentikan oleh karakter NULL tambahan. Jika buffer tidak cukup besar untuk menyimpan daftar lengkap, buffer menyimpan daftar sebanyak mungkin.

[in] cchBufferLength

Panjang buffer lpszVolumePathNames , dalam TCHAR, termasuk semua karakter NULL .

[out] lpcchReturnLength

Jika panggilan berhasil, parameter ini adalah jumlah TCHAR yang disalin ke buffer lpszVolumePathNames . Jika tidak, parameter ini adalah ukuran buffer yang diperlukan untuk menyimpan daftar lengkap, dalam 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 buffer tidak cukup besar untuk menyimpan daftar lengkap, kode kesalahan ERROR_MORE_DATA dan parameter lpcchReturnLength menerima ukuran buffer yang diperlukan.

Keterangan

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) Ya
Sistem File Tangguh (ReFS) Ya
 

SMB tidak mendukung fungsi manajemen volume.

Contoh

Misalnya, lihat Menampilkan Jalur Volume.

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 fileapi.h (sertakan Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

Folder Terpasang

Fungsi Manajemen Volume