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

设置此文件系统映像的卷名。

语法

HRESULT put_VolumeName(
  [in] BSTR newVal
);

参数

[in] newVal

包含此文件系统映像的卷名称的字符串。

返回值

S_OK成功后返回,但其他成功代码可能由于实现而返回。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
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