IFileSystemImage::ImportSpecificFileSystem 方法 (imapi2fs.h)
从光盘导入特定文件系统。
语法
HRESULT ImportSpecificFileSystem(
[in] FsiFileSystems fileSystemToUse
);
parameters
[in] fileSystemToUse
标识要导入的文件系统。 有关可能的值,请参阅 FsiFileSystems 枚举类型。
返回值
成功后返回S_OK,但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:
返回代码 | 说明 |
---|---|
|
为参数 %1!ls! 指定的值无效。
值:0xC0AAB101 |
|
必须在调用此方法之前设置 MultisessionInterfaces 属性。
值:0xC0AAB15D |
|
启动对象只能包含在初始光盘映像中。
值:0xC0AAB149 |
|
光学介质为空。
值:0xC0AAB150 |
|
未能分配所需的内存。
值:0x8007000E |
|
IMAPI 不支持当前媒体上提供的) (多线程类型。
值:0xC0AAB15C 注意 如果录制设备中没有媒体,则 IFileSystemImage::ImportFileSystem 方法返回此错误。
|
|
由于从介质导入的上一个会话的布局不兼容,操作失败。
值:0xC0AAB133 |
|
指定的光盘不包含 “%1!ls!” 文件系统)。
值:0xC0AAB152 |
|
为导入指定的文件系统包含无效的文件名。
值: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 |