IJolietDiscMaster：：AddData 方法 (imapi.h)

將根記憶體的內容新增至暫存映像檔。 系統會列舉此記憶體，將所有子記憶體和數據流放在階段映射檔的根文件系統中。 子記憶體會變成資料夾，串流會變成檔案。 您可以重複對此方法進行多次呼叫，以緩慢暫存圖像檔，而不會浪費建置儲存盤案的硬碟空間量。

語法

HRESULT AddData(
  [in] IStorage *pStorage,
  [in] long     lFileOverwrite
);

參數

[in] pStorage

要加入暫存映像檔根目錄之記憶體的路徑。

[in] lFileOverwrite

如果此參數為非零，請使用相同名稱覆寫現有的檔案。 否則，新增的最後一個檔案會出現在目錄中。

傳回值

成功時會傳回S_OK，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

備註

當您重複 AddData 作業時，具有重複檔案的資料夾會導致 lFileOverwrite 測試。 如果旗標為非零，則會覆寫檔案。 具有衝突名稱的舊版檔案仍會從圖像檔寫入磁碟。 如果 lFileOverwrite 為零，且具有相同名稱的檔案存在， AddData 會失敗並IMAPI_E_FILEEXISTS。

雖然在呼叫 IDiscMaster：：SetActiveDiscRecorder 之後多次呼叫 AddData，但每當啟動新的映射時，都必須呼叫 SetActiveDiscRecorder，而且不論在建立前一個映像之前，都一樣，

如果呼叫這個方法會覆寫可用的數據區塊數目，此方法會傳回IMAPI_E_DISCFULL，並忽略要加入的所有數據。 這可確保最終的 Joliet 檔案系統不會損毀。

規格需求

另請參閱

IJolietDiscMaster