Fungsi SetVolumeLabelA (winbase.h)

Mengatur label volume sistem file.

Sintaksis

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 menghapus label yang ada dari volume yang ditentukan dan tidak menetapkan label baru.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Komentar

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. 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
Failover Transparan (TFO) SMB 3.0	Tidak
SMB 3.0 dengan Scale-out File Shares (SO)	Tidak
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

 

SMB tidak mendukung fungsi manajemen volume.

Nota

Header winbase.h mendefinisikan SetVolumeLabel sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat	Nilai
klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetVolumeInformation

Fungsi Manajemen Volume