IFileSystemImage：：ImportSpecificFileSystem 方法 (imapi2fs.h)

從磁片匯入特定的檔案系統。

語法

HRESULT ImportSpecificFileSystem(
  [in] FsiFileSystems fileSystemToUse
);

參數

[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