Fungsi GetLogicalDriveStringsW (fileapi.h)

Artikel
03/14/2023

Mengisi buffer dengan string yang menentukan drive yang valid dalam sistem.

Sintaks

DWORD GetLogicalDriveStringsW(
  [in]  DWORD  nBufferLength,
  [out] LPWSTR lpBuffer
);

Parameter

[in] nBufferLength

Ukuran maksimum buffer yang diacu oleh lpBuffer, dalam TCHAR. Ukuran ini tidak termasuk karakter null yang mengakhiri. Jika parameter ini nol, lpBuffer tidak digunakan.

[out] lpBuffer

Penunjuk ke buffer yang menerima serangkaian string yang dihentikan null, satu untuk setiap drive yang valid dalam sistem, ditambah dengan karakter null tambahan. Setiap string adalah nama perangkat.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah panjang, dalam karakter, dari string yang disalin ke buffer, tidak termasuk karakter null yang mengakhiri. Perhatikan bahwa karakter null ANSI-ASCII menggunakan satu byte, tetapi karakter null Unicode (UTF-16) menggunakan dua byte.

Jika buffer tidak cukup besar, nilai yang dikembalikan lebih besar dari nBufferLength. Ini adalah ukuran buffer yang diperlukan untuk menahan string drive.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, gunakan fungsi GetLastError .

Keterangan

Setiap string dalam buffer dapat digunakan di mana pun direktori akar diperlukan, seperti untuk fungsi GetDriveType dan GetDiskFreeSpace .

Fungsi ini mengembalikan perangkaian drive di namespace Perangkat MS-DOS Global dan Lokal. Jika drive ada di kedua namespace layanan, fungsi ini akan mengembalikan entri di namespace Layanan Perangkat MS-DOS Lokal. Untuk informasi selengkapnya, lihat Menentukan Nama Perangkat MS DOS.

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 Mendapatkan Nama File Dari Handel File.

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

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

Fungsi Manajemen Volume