IJolietDiscMaster::AddData メソッド (imapi.h)
ルート ストレージの内容をステージング イメージ ファイルに追加します。 このストレージは、ステージ イメージ ファイルのルート ファイル システムにすべてのサブストレージとストリームを配置するために列挙されます。 サブストレージはフォルダーになり、ストリームはファイルになります。 このメソッドの複数の呼び出しを繰り返して、ストレージ ファイルを構築するハード ドライブ領域の量を無駄にすることなく、イメージ ファイルをゆっくりとステージングできます。
構文
HRESULT AddData(
[in] IStorage *pStorage,
[in] long lFileOverwrite
);
パラメーター
[in] pStorage
ステージングされたイメージ ファイルのルートにサブ項目を追加するストレージへのパス。
[in] lFileOverwrite
このパラメーターが 0 以外の場合は、同じ名前の既存のファイルを上書きします。 それ以外の場合は、最後に追加されたファイルがディレクトリに表示されます。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
注釈
AddData 操作を繰り返すと、重複するファイルを含むフォルダーによって lFileOverwrite のテストが行われます。 フラグが 0 以外の場合、ファイルは上書きされます。 名前が競合する以前のファイルは、イメージ ファイルからディスクに書き込まれます。 lFileOverwrite が 0 で、同じ名前のファイルが存在する場合、AddData はIMAPI_E_FILEEXISTSで失敗します。
AddData は IDiscMaster::SetActiveDiscRecorder を呼び出した後に複数回呼び出すことができますが、前のイメージの作成で使用したバーナーが同じかどうかに関係なく、新しいイメージが開始されるたびに、最初の AddData 呼び出しの直前に SetActiveDiscRecorder を呼び出す必要があります。
このメソッドを呼び出すと、使用可能なデータ ブロックの数がオーバーランする場合、メソッドは IMAPI_E_DISCFULLを返し、追加されたすべてのデータを無視します。 これにより、最終的な Joliet ファイル システムが破損しないようにします。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi.h |
| Library | Uuid.lib |
| [DLL] | Actxprxy.dll |