IFileSystemImage：：ImportSpecificFileSystem 方法 (imapi2fs.h)

从光盘导入特定文件系统。

语法

HRESULT ImportSpecificFileSystem(
  [in] FsiFileSystems fileSystemToUse
);

parameters

[in] fileSystemToUse

标识要导入的文件系统。 有关可能的值，请参阅 FsiFileSystems 枚举类型。

返回值

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

返回代码	说明
IMAPI_E_INVALID_PARAM	为参数 %1！ls！ 指定的值无效。 值：0xC0AAB101
IMAPI_E_MULTISESSION_NOT_SET	必须在调用此方法之前设置 MultisessionInterfaces 属性。 值：0xC0AAB15D
IMAPI_E_BOOT_OBJECT_CONFLICT	启动对象只能包含在初始光盘映像中。 值：0xC0AAB149
IMAPI_E_EMPTY_DISC	光学介质为空。 值：0xC0AAB150
E_OUTOFMEMORY	未能分配所需的内存。 值：0x8007000E
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	IMAPI 不支持当前媒体上提供的) (多线程类型。 值：0xC0AAB15C 注意 如果录制设备中没有媒体，则 IFileSystemImage：：ImportFileSystem 方法返回此错误。
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION	由于从介质导入的上一个会话的布局不兼容，操作失败。 值：0xC0AAB133
IMAPI_E_FILE_SYSTEM_NOT_FOUND	指定的光盘不包含 “%1！ls！” 文件系统）。 值：0xC0AAB152
IMAPI_E_INVALID_PATH	为导入指定的文件系统包含无效的文件名。 值：0xC0AAB110

注解

必须先调用 IFileSystemImage：:p ut_MultisessionInterfaces ，然后才能调用 IFileSystemImage：：ImportSpecificFileSystem。 此外，建议在 IFileSystemImage：:p ut_MultisessionInterfaces 之前调用 IDiscFormat2：：get_MediaHeuristicallyBlank，以验证媒体是否为空。

在构建内存中文件系统的过程中，可以随时调用此方法。 如果在导入过程中，内存中副本中已存在文件或目录，则内存中版本将保留;导入的文件将被丢弃。

在可重新写媒体 (DVD+/-RW、DVDRAM、BD-RE) 上，如果第一个会话具有ISO9660文件系统，则由于文件系统限制，不支持导入或刻录第二个会话。

此方法仅读取文件信息。 如果项是文件，则调用 IFsiDirectoryItem：：AddFile、IFsiDirectoryItem：：AddTree 或 IFsiDirectoryItem：：Add 方法时复制文件数据。

如果上一个会话中文件系统的布局与 IMAPI 用于为结果映像创建请求的文件系统的布局不兼容，则此方法返回 IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION 。 有关详细信息，请参阅 IFileSystemImage：:p ut_FileSystemsToCreate 方法文档。 如果尚未找到 fileSystemToUse 指定的文件系统，此方法将返回 IMAPI_E_FILE_SYSTEM_NOT_FOUND。

要求

最低受支持的客户端	Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	imapi2fs.h

另请参阅

IFileSystemImage