Metode IFileSystemImage::ImportFileSystem (imapi2fs.h)

Mengimpor sistem berkas asali pada cakram saat ini.

Sintaks

HRESULT ImportFileSystem(
  [out] FsiFileSystems *importedFileSystem
);

Parameter

[out] importedFileSystem

Mengidentifikasi sistem file yang diimpor. Untuk nilai yang mungkin, lihat jenis enumerasi FsiFileSystems .

Menampilkan nilai

S_OK dikembalikan pada keberhasilan, tetapi kode keberhasilan lainnya dapat dikembalikan sebagai hasil dari implementasi. Kode kesalahan berikut biasanya dikembalikan pada kegagalan operasi, tetapi tidak mewakili satu-satunya nilai kesalahan yang mungkin:

Menampilkan kode	Deskripsi
E_POINTER	Pointer tidak valid. Nilai: 0x80004003
IMAPI_E_MULTISESSION_NOT_SET	Properti MultisessionInterfaces harus diatur sebelum memanggil metode ini. Nilai: 0xC0AAB15D
IMAPI_E_EMPTY_DISC	Media optik kosong. Nilai: 0xC0AAB150
IMAPI_E_NO_SUPPORTED_FILE_SYSTEM	Cakram yang ditentukan tidak berisi salah satu sistem file yang didukung. Nilai: 0xC0AAB151 Catatan Sistem file kemungkinan didukung untuk operasi, tetapi pada tingkat rendah, IMAPI2 saat memanggil ImportFileSystem, ia memiliki pengecualian generik/penanganan kesalahan dan melaporkan kembali kesalahan 0xC0AAB151. Jika disk tidak diperoleh untuk akses eksklusif atau akses ditolak, kesalahan ini tidak akan dilaporkan.
IMAPI_E_BOOT_OBJECT_CONFLICT	Objek boot hanya dapat disertakan dalam gambar disk awal. Nilai: 0xC0AAB149
E_OUTOFMEMORY	Gagal mengalokasikan memori yang diperlukan. Nilai: 0x8007000E
IMAPI_E_IMAGE_TOO_BIG	Nilai yang ditentukan untuk properti FreeMediaBlocks terlalu kecil untuk perkiraan ukuran gambar berdasarkan data saat ini. Nilai: 0xC0AAB121
IMAPI_E_INVALID_PARAM	Nilai yang ditentukan untuk parameter %1!ls! tidak valid. Nilai: 0xC0AAB101
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	IMAPI tidak mendukung jenis multisesi yang disediakan pada media saat ini. Nilai: 0xC0AAB15C Catatanmetode IFileSystemImage::ImportFileSystem mengembalikan kesalahan ini jika tidak ada media di perangkat perekaman.
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION	Operasi gagal karena tata letak sesi sebelumnya yang tidak kompatibel yang diimpor dari media. Nilai: 0xC0AAB133

Keterangan

Anda harus memanggil IFileSystemImage::p ut_MultisessionInterfaces sebelum memanggil IFileSystemImage::ImportFileSystem. Selain itu, disarankan agar IDiscFormat2::get_MediaHeuristicallyBlank dipanggil sebelum IFileSystemImage::p ut_MultisessionInterfaces untuk memverifikasi bahwa media tidak kosong.

Jika cakram berisi lebih dari satu sistem file, hanya satu sistem file yang diimpor. Metode ini memilih sistem file untuk diimpor dalam urutan berikut: UDF, Joliet, ISO 9660. Impor mencakup mentransfer direktori dan file ke struktur sistem file dalam memori.

Anda dapat memanggil metode ini kapan saja selama pembangunan sistem file dalam memori. Jika, selama impor, file atau direktori sudah ada dalam salinan dalam memori, versi dalam memori akan dipertahankan; file yang diimpor akan dibuang.

Untuk menentukan sistem file mana yang merupakan sistem file default untuk disk, panggil metode IFileSystemImage::GetDefaultFileSystemForImport .

Metode ini hanya membaca informasi file. Jika item adalah file, data file disalin saat memanggil IFsiDirectoryItem::AddFile, IFsiDirectoryItem::AddTree, atau IFsiDirectoryItem::Add method.

Metode ini mengembalikan IMAPI_E_NO_SUPPORTED_FILE_SYSTEM jika sistem file yang didukung tidak ditemukan di sesi terakhir. Selain itu, metode ini mengembalikan IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION jika tata letak sistem file di sesi terakhir tidak kompatibel dengan tata letak yang digunakan oleh IMAPI untuk pembuatan sistem file yang diminta untuk gambar hasil. Untuk detail selengkapnya, lihat dokumentasi metode IFileSystemImage::p ut_FileSystemsToCreate .

Persyaratan

Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	imapi2fs.h

Lihat juga

FsiFileSystems

IFileSystemImage