Fungsi GetVolumePathNamesForVolumeNameW (fileapi.h)
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 |