SetVolumeLabelW 函式 （winbase.h）

設定檔案系統磁碟區的標籤。

語法

BOOL SetVolumeLabelW(
  [in, optional] LPCWSTR lpRootPathName,
  [in, optional] LPCWSTR lpVolumeName
);

參數

[in, optional] lpRootPathName

字串的指標，其中包含磁碟區的驅動器號（例如 X：）或與磁碟區相關聯之掛接資料夾的路徑（例如 Y：\MountX）。 字串結尾必須是尾端反斜杠 （''）。 如果此參數 NULL，則會使用目前目錄的根目錄。

[in, optional] lpVolumeName

字串的指標，其中包含磁碟區的新標籤。 如果此參數 NULL，函式會從指定的磁碟區中刪除任何現有的標籤，而不會指派新的標籤。

傳回值

如果函式成功，則傳回值為非零值。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

磁碟區標籤長度上限為32個字元。

FAT 檔案系統：磁碟區標籤長度上限為 11 個字元。

卷標是使用者指派給磁碟區的用戶易記名稱，可讓您更容易辨識。 磁碟區可以有標籤、驅動器號、兩者或兩者都沒有。 如需詳細資訊，請參閱 為磁碟區命名。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此功能。

科技	支援
伺服器消息塊 （SMB） 3.0 通訊協定	不
SMB 3.0 透明故障轉移 （TFO）	不
具有向外延展檔案共用的SMB 3.0（SO）	不
叢集共用磁碟區檔案系統 （CsvFS）	是的
復原檔案系統 （ReFS）	是的

 

SMB 不支援磁碟區管理功能。

注意

winbase.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetVolumeLabel 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

GetVolumeInformation

磁碟區管理功能