IFileSystemImage::ImportFileSystem メソッド (imapi2fs.h)
現在のディスクに既定のファイル システムをインポートします。
構文
HRESULT ImportFileSystem(
[out] FsiFileSystems *importedFileSystem
);
パラメーター
[out] importedFileSystem
インポートされたファイル システムを識別します。 使用できる値については、 FsiFileSystems 列挙型に関するページを 参照してください。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
| リターン コード | 説明 |
|---|---|
|
ポインターが無効です。
値: 0x80004003 |
|
MultisessionInterfaces プロパティは、このメソッドを呼び出す前に設定する必要があります。
値: 0xC0AAB15D |
|
光メディアが空です。
値: 0xC0AAB150 |
|
指定されたディスクに、サポートされているファイル システムが含まれていません。
値: 0xC0AAB151 メモ ファイル システムは操作でサポートされている可能性がありますが、ImportFileSystem を呼び出すときの低レベルの IMAPI2 では、一般的な例外/エラー処理が行われ、エラー 0xC0AAB151が報告されます。 排他的アクセス用にディスクが取得されていない場合、またはアクセスが拒否された場合、このエラーは報告されません。
|
|
ブート オブジェクトは、初期ディスク イメージにのみ含めることができます。
値: 0xC0AAB149 |
|
必要なメモリを割り当てませんでした。
値: 0x8007000E |
|
FreeMediaBlocks プロパティに指定された値が、現在のデータに基づく推定イメージ サイズに対して小さすぎます。
値: 0xC0AAB121 |
|
パラメーター %1!ls! に指定された値が無効です。
値: 0xC0AAB101 |
|
IMAPI では、現在のメディアで提供されているマルチセクションの種類はサポートされていません。
値: 0xC0AAB15C メモIFileSystemImage::ImportFileSystem メソッドは、記録デバイスにメディアがない場合、このエラーを返します。
|
|
メディアからインポートされた以前のセッションのレイアウトが互換性がないため、操作に失敗しました。
値: 0xC0AAB133 |
解説
IFileSystemImage::ImportFileSystem を呼び出す前に、IFileSystemImage::p ut_MultisessionInterfaces を呼び出す必要があります。 また、メディアが空白でないことを確認するには、IFileSystemImage::p ut_MultisessionInterfaces の前に IDiscFormat2::get_MediaHeuristicallyBlank を呼び出することをお勧めします。
ディスクに複数のファイル システムが含まれている場合は、1 つのファイル システムのみがインポートされます。 このメソッドは、インポートするファイル システムを 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 |