IMsmMerge：：Merge 方法 (mergemod.h)

Merge方法會執行目前資料庫和目前模組的合併。合併會將模組中的元件附加至 Feature所識別的功能。模組目錄樹狀結構的根目錄會重新導向至 RedirectDir所指定的位置。如需詳細資訊，請參閱 Merge 物件的 Merge 方法。

IMsmMerge2：：Merge Mergemod.dll 2.0 版或更新版本。

IMsmMerge：：Merge 所有 Mergemod.dll 版本。

語法

HRESULT Merge(
  [in] const BSTR Feature,
  [in] const BSTR RedirectDir
);

[in] Feature

資料庫中的功能名稱。 LPCWSTR可用來取代BSTR。

[in] RedirectDir

資料庫目錄資料表中專案的索引鍵。 LPCWSTR可用來取代BSTR。此參數可以是 Null 或空字串。

Merge函式會傳回下列值。

值	意義
E_FAIL	合併失敗，嚴重失敗。這表示操作錯誤，而且不是失敗合併的正常錯誤傳回。
S_FALSE	函式成功，但發生錯誤，而且合併本身可能無效。
E_INVALIDARG	其中一個引數無效。
E_OUTOFMEMORY	系統記憶體不足，無法完成作業。
S_OK	此函數已成功。

此函式會執行目前資料庫和目前模組的合併。模組目錄樹狀結構的根目錄會重新導向至 RedirectDir所指定的位置。如果發生任何合併衝突，包括排除專案，它們會放在錯誤列舉值中以供稍後擷取，但不會造成合併失敗。您可以使用 get_Errors 函式來擷取錯誤。錯誤和參考訊息會張貼至目前的記錄檔。

請注意， Merge 函式會取得模組中的所有功能參考，並以功能參考取代模組資料庫中所有出現的 Null GUID。 For more information, see Referencing Features in Merge Modules.

合併完成後，模組中的元件會附加至 Feature所識別的功能。此功能必須已經存在，而且尚未建立。

模組可以使用 Connect 函式附加至其他功能。請注意，呼叫 Connect 函式只會建立功能元件關聯。它不會修改已經合併到資料庫中的資料列。

除非使用bCommit設為TRUE呼叫CloseDatabase函式，否則對資料庫所做的變更不會儲存到磁片。