setVolumeLabelA 函式 (winbase.h)

  • 發行項

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

語法

BOOL SetVolumeLabelA(
  [in, optional] LPCSTR lpRootPathName,
  [in, optional] LPCSTR lpVolumeName
);

參數

[in, optional] lpRootPathName

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

[in, optional] lpVolumeName

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

傳回值

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

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

備註

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

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

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

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

技術 支援
伺服器消息塊 (SMB) 3.0 通訊協定 No
SMB 3.0 透明故障轉移 (TFO) No
具有向外延展檔案共用的SMB 3.0 (SO) No
叢集共用磁碟區文件系統 (CsvFS) Yes
彈性檔案系統 (ReFS) Yes
 

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

注意

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

規格需求

需求 值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

GetVolumeInformation

磁碟區管理功能