IFileSystemImage2::p ut_BootImageOptionsArray 方法 (imapi2fs.h)

设置将用于生成文件系统映像的启动选项数组。 与 IFileSystemImage::p ut_BootImageOptions 不同,此方法不会创建每个启动选项数组元素的完整副本,而是使用对每个元素的引用。

语法

HRESULT put_BootImageOptionsArray(
  [in] SAFEARRAY *newVal
);

参数

[in] newVal

将用于生成文件系统映像的启动映像的 IBootOptions 接口列表。 列表的每个元素都是VT_DISPATCH类型的 VARIANT

返回值

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

返回代码 说明
E_NOINTERFACE
不支持此类接口。

值:0x80004002

IMAPI_E_BOOT_OBJECT_CONFLICT
启动对象只能包含在初始光盘映像中。

值:0xC0AAB149

IMAPI_E_BOOT_IMAGE_DATA
无法将启动对象添加到映像。

值:0xC0AAB148

注解

SAFEARRAY 必须是一维数组。 允许使用零大小的数组,但这将导致常规的不可启动光盘。

光盘上的启动映像序列将与 SAFEARRAY 中指定的序列匹配。 put_BootImageOptionsArrayput_BootImageOptions都用于指定启动映像,后者在创建的光盘映像生效之前调用。

get_BootImageOptionsArrayget_BootImageOptions函数将检索上次调用put_BootImageOptionsArray或put_BootImageOptions的结果。 应同步使用这些函数。

要求

要求
最低受支持的客户端 Windows Vista SP1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 imapi2fs.h

另请参阅

IFileSystemImage2

IFileSystemImage2::get_BootImageOptionsArray