共用方式為

IFileSystemImage：:p ut_VolumeName 方法 (imapi2fs.h)

  • 發行項

設定此檔案系統映像的磁碟區名稱。

語法

HRESULT put_VolumeName(
  [in] BSTR newVal
);

參數

[in] newVal

包含此檔案系統映像之磁碟區名稱的字串。

傳回值

S_OK會在成功時傳回，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

傳回碼 Description
IMAPI_E_INVALID_VOLUME_NAME
 為參數 %1！ls！ 指定的值無效。

值：0xC0AAB101

備註

字串限制為15個字元。 若為 ISO 9660 光碟，磁碟區名稱可以使用下列字元：

  • “A” 到 “Z”
  • “0” 到 “9”
  • “_” (底線)
若為 Joliet 和 UDF 光碟，磁碟區名稱可以使用下列字元：
  • “a” 到 “z”
  • “A” 到 “Z”
  • “0” 到 “9”
  • “.” (期間)
  • “_” (底線)
如果您未指定磁碟區名稱，則會使用建立結果對象的系統日期和時間來產生預設磁碟區名稱。

規格需求

需求 值
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 imapi2fs.h

另請參閱

IFileSystemImage

IFileSystemImage：：get_ImportedVolumeName

IFileSystemImage：：get_VolumeName