Merge.MergeEx 方法
Merge 物件的 MergeEx方法相當於Merge函式，不同之處在于它會採用額外的引數。 pConfiguration引數是由用戶端實作的介面。 引數可以是 Null。 此引數的存在表示用戶端能夠支援組態功能，但不強制用戶端提供任何特定可設定專案的組態資料。
Merge方法會執行目前資料庫和目前模組的合併。 合併會將模組中的元件附加至 功能所識別的功能。 模組目錄樹狀結構的根目錄會重新導向至 RedirectDir所指定的位置。
語法
Merge.MergeEx(
Feature,
RedirectDir,
pConfiguration
)
參數
-
功能
-
資料庫中的功能名稱。
-
RedirectDir
-
資料庫的 Directory 資料表 中專案的索引鍵。 此參數可以是 null 或空字串。
-
pConfiguration
-
pConfiguration引數是由用戶端實作的介面。 引數可以是 Null。 此引數的存在表示用戶端能夠支援組態功能，但不強制用戶端提供任何特定可設定專案的組態資料。
傳回值
這個方法不會傳回值。
備註
合併完成後，模組中的元件會附加至 Feature所識別的功能。 此功能不是建立的，而且必須是現有的功能。 模組可以使用 Connect 方法附加至其他功能。
只有在使用bCommit設為TRUE呼叫CloseDatabase方法時，才會儲存對資料庫所做的變更。
如果發生任何合併衝突，包括排除專案，則會將它們放在錯誤列舉值中以供稍後擷取，但不會造成合併失敗。 錯誤可以透過 Errors 屬性擷取。 錯誤和參考訊息會張貼至目前的記錄檔。
合併失敗時，因為模組組態不正確， MergeEx 函式會傳回E_FAIL。 這包括下列 msmErrorType 錯誤： msmErrorBadNullSubstitution、 msmErrorBadSubstitutionType、 msmErrorBadNullResponse、 msmErrorMissingConfigItem和 msmErrorDataRequestFailed。 這些錯誤會導致發生錯誤時立即停止合併。 當 MergeEx 傳回E_FAIL時，錯誤物件仍會新增至列舉值。 如需 msmErrorType 錯誤的詳細資訊，請參閱 get_Type Function (Error 物件) 。 所有其他錯誤都會導致 MergeEx 傳回S_FALSE，並導致合併繼續。
C++
請參閱 MergeEx 函 式。
規格需求
| 需求 | 值 |
|---|---|
| 版本 |
Mergemod.dll 2.0 或更新版本 |
| 標頭 |
|
| DLL |
|