Fungsi SetVolumeLabelA (winbase.h)
Mengatur label volume sistem file.
Sintaks
BOOL SetVolumeLabelA(
[in, optional] LPCSTR lpRootPathName,
[in, optional] LPCSTR lpVolumeName
);
Parameter
[in, optional] lpRootPathName
Penunjuk ke string yang berisi huruf drive volume (misalnya, X:) atau jalur folder yang dipasang yang terkait dengan volume (misalnya, Y:\MountX). String harus diakhir dengan garis miring terbelakang (''). Jika parameter ini NULL, akar direktori saat ini digunakan.
[in, optional] lpVolumeName
Penunjuk ke string yang berisi label baru untuk volume. Jika parameter ini NULL, fungsi akan menghapus label yang ada dari volume yang ditentukan dan tidak menetapkan label baru.
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.
Keterangan
Panjang label volume maksimum adalah 32 karakter.
Sistem file FAT: Panjang label volume maksimum adalah 11 karakter.
Label adalah nama yang mudah digunakan yang ditetapkan pengguna ke volume untuk membuatnya lebih mudah dikenali. Volume dapat memiliki label, huruf kandar, keduanya, atau tidak keduanya. Untuk informasi selengkapnya, 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 Berbagi File Peluasan Skala (SO) | Tidak |
Sistem File Volume Bersama Kluster (CsvFS) | Ya |
Sistem File Tangguh (ReFS) | Ya |
SMB tidak mendukung fungsi manajemen volume.
Catatan
Header winbase.h mendefinisikan SetVolumeLabel sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | winbase.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |