IFileSystemImage：：ImportFileSystem 方法 (imapi2fs.h)

匯入目前磁片上的預設檔案系統。

語法

HRESULT ImportFileSystem(
  [out] FsiFileSystems *importedFileSystem
);

參數

[out] importedFileSystem

識別匯入的檔案系統。 如需可能的值，請參閱 FsiFileSystems 列舉類型。

傳回值

成功時會傳回S_OK，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

傳回碼	描述
E_POINTER	指標無效。 值：0x80004003
IMAPI_E_MULTISESSION_NOT_SET	在呼叫此方法之前，必須先設定 MultisessionInterfaces 屬性。 值：0xC0AAB15D
IMAPI_E_EMPTY_DISC	光學媒體是空的。 值：0xC0AAB150
IMAPI_E_NO_SUPPORTED_FILE_SYSTEM	指定的磁片不包含其中一個支援的檔案系統。 值：0xC0AAB151 注意 作業可能支援檔案系統，但在低層級呼叫 ImportFileSystem 時，IMAPI2 具有一般例外狀況/錯誤處理，並回報錯誤0xC0AAB151。 如果未針對獨佔存取或拒絕存取取得磁片，則不會報告此錯誤。
IMAPI_E_BOOT_OBJECT_CONFLICT	開機物件只能包含在初始磁片映射中。 值：0xC0AAB149
E_OUTOFMEMORY	無法配置所需的記憶體。 值：0x8007000E
IMAPI_E_IMAGE_TOO_BIG	針對 FreeMediaBlocks 屬性指定的值對於根據目前資料估計的影像大小太小。 值：0xC0AAB121
IMAPI_E_INVALID_PARAM	為參數 %1！ls！ 指定的值無效。 值：0xC0AAB101
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	IMAPI 不支援目前媒體上提供的多重類型 (類型) 。 值：0xC0AAB15C 注意IFileSystemImage：：ImportFileSystem 方法會在錄製裝置中沒有媒體時傳回此錯誤。
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION	作業失敗，因為先前從媒體匯入的會話配置不相容。 值：0xC0AAB133

備註

您必須先呼叫 IFileSystemImage：:p ut_MultisessionInterfaces ，才能呼叫 IFileSystemImage：：ImportFileSystem。 此外，建議您在IFileSystemImage：:p ut_MultisessionInterfaces之前呼叫IDiscFormat2：：get_MediaHeuristicallyBlank，以確認媒體不是空白。

如果磁片包含多個檔案系統，則只會匯入一個檔案系統。 此方法會依下列順序選擇要匯入的檔案系統：UDF、Joliet、ISO 9660。 匯入包括將目錄和檔案傳輸到記憶體內部檔案系統結構。

您可以在建構記憶體內部檔案系統期間隨時呼叫此方法。 如果在匯入期間，檔案或目錄已存在於記憶體內部複本中，則會保留記憶體內部版本;匯入的檔案將會捨棄。

若要判斷哪個檔案系統是磁片的預設檔案系統，請呼叫 IFileSystemImage：：GetDefaultFileSystemForImport 方法。

這個方法只會讀取檔案資訊。 如果專案是檔案，則會在呼叫 IFsiDirectoryItem：：AddFile、 IFsiDirectoryItem：：AddTree或 IFsiDirectoryItem：：Add 方法時複製檔案資料。

如果最後一個會話中找不到支援的檔案系統，這個方法會傳回 IMAPI_E_NO_SUPPORTED_FILE_SYSTEM 。 此外，如果上一個會話中的檔案系統配置與 IMAPI 針對結果映射建立要求檔案系統所使用的配置不相容，這個方法會傳回 IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION 。 如需詳細資訊，請參閱 IFileSystemImage：:p ut_FileSystemsToCreate 方法檔。

需求

最低支援的用戶端	Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	imapi2fs.h

另請參閱

FsiFileSystems

IFileSystemImage