次の方法で共有


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::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

関連項目

IFileSystemImage