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::ImportSpecificFileSystem を呼び出す前に、IFileSystemImage::p ut_MultisessionInterfaces を呼び出す必要があります。 また、メディアが空白でないことを確認するには、IFileSystemImage::p ut_MultisessionInterfaces の前に IDiscFormat2::get_MediaHeuristicallyBlank を呼び出することをお勧めします。
このメソッドは、メモリ内ファイル システムの構築中にいつでも呼び出すこともできます。 インポート中に、メモリ内コピーにファイルまたはディレクトリが既に存在する場合、インメモリ バージョンは保持されます。インポートされたファイルは破棄されます。
書き込み可能なメディア (DVD+/-RW、DVDRAM、BD-RE) では、ファイル システムの制限により、最初のセッションに ISO9660 ファイル システムがある場合、2 番目のセッションのインポートまたは書き込みはサポートされません。
このメソッドは、ファイル情報のみを読み取ります。 アイテムがファイルの場合、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 |