The Merge method of the Merge object executes a merge of the current database and current module. The merge attaches the components in the module to the feature identified by Feature. The root of the module's directory tree is redirected to the location given by RedirectDir.

The Merge method can only be called once to merge a particular combination of .msi and .msm files.

Syntax

Script
Merge(
  Feature,
  RedirectDir
)

Parameters

Feature

The name of a feature in the database.

RedirectDir

The key of an entry in the Directory table of the database. This parameter may be null or an empty string.

Return Value

Remarks

Once the merge is complete, components in the module are attached to the feature identified by Feature. This feature is not created and must be an existing feature. Note that the Merge method gets all the feature references in the module and substitutes the feature reference for all occurrences of the null GUID in the module database. For more information, see Referencing Features in Merge Modules.

The module may be attached to additional features using the Connect method. Note that calling the Connect method only creates feature-component associations. It does not modify the rows that have already been merged in to the database.

Changes made to the database are saved if and only if the CloseDatabase method is called with bCommit set to TRUE.

If any merge conflicts occur, including exclusions, they are placed in the error enumerator for later retrieval, but does not cause the merge to fail. Errors may be retrieved through the Errors property. Errors and informational messages are posted to the current log file.

C++

See Merge function.

Requirements

Send comments about this topic to Microsoft

Build date: 8/13/2009