IMsmMerge::Merge 方法 (mergemod.h)
Merge 方法會執行目前資料庫和目前模組的合併。 合併會將模組中的元件附加至 Feature所識別的功能。 模組目錄樹狀結構的根目錄會重新導向至 RedirectDir 所指定的位置,。 如需詳細資訊,請參閱 Merge 物件的 Merge 方法。
IMsmMerge2::Merge Mergemod.dll 2.0 版或更新版本。
語法
HRESULT Merge(
[in] const BSTR Feature,
[in] const BSTR RedirectDir
);
參數
[in] Feature
資料庫中功能的名稱。 LPCWSTR 可用來取代 BSTR 。
[in] RedirectDir
資料庫目錄數據表中專案的索引鍵。 LPCWSTR 可用來取代 BSTR 。 此參數可以是 Null 或空字串。
傳回值
Merge 函式會傳回下列值。
價值 | 意義 |
---|---|
|
合併會災難性地失敗。 這表示作業錯誤,而且不是失敗合併的一般錯誤傳回。 |
|
函式成功,但發生錯誤且合併本身可能無效。 |
|
其中一個自變數無效。 |
|
系統記憶體不足,無法完成作業。 |
|
函式成功。 |
言論
此函式會執行目前資料庫和目前模組的合併。 模組目錄樹狀結構的根目錄會重新導向至 RedirectDir 所指定的位置,。 如果發生任何合併衝突,包括排除專案,則會將它們放在錯誤列舉值中,以供稍後擷取,但不會導致合併失敗。 您可以使用 get_Errors 函式來擷取錯誤。 錯誤和參考訊息會張貼至目前的記錄檔。
請注意,Merge 函式會取得模組中的所有功能參考,並以功能參考取代模塊資料庫中所有出現的 Null GUID。 如需詳細資訊,請參閱 在合併模組中參考功能。
合併完成後,模組中的元件會附加至功能 功能所識別的功能。 這項功能必須已經存在,而且尚未建立。
模組可以使用 Connect 函式附加至其他功能。 請注意,呼叫 Connect 函式只會建立功能元件關聯。 它不會修改已經合併至資料庫的數據列。
除非呼叫 CloseDatabase 函式,否則對資料庫所做的變更不會儲存至磁碟,bCommit 設定為 true true。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Mergemod.dll 1.0 或更新版本 |
目標平臺 | 窗戶 |
標頭 | mergemod.h |
DLL | Mergemod.dll |