IFileSystemImage::ImportSpecificFileSystem 方法 (imapi2fs.h)
從磁片匯入特定的檔案系統。
語法
HRESULT ImportSpecificFileSystem(
[in] FsiFileSystems fileSystemToUse
);
參數
[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 |