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