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

Lihat juga

GetVolumeInformation

Fungsi Manajemen Volume