共用方式為


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。 如需詳細資訊,請參閱 在合併模組中參考功能

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

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

除非呼叫 CloseDatabase 函式,否則對資料庫所做的變更不會儲存至磁碟,bCommit 設定為 true true

要求

要求 價值
最低支援的用戶端 Mergemod.dll 1.0 或更新版本
目標平臺 窗戶
標頭 mergemod.h
DLL Mergemod.dll

另請參閱

合併模組自動化