The Merge method 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. For more information, see the Merge method of the Merge object.

IMsmMerge2::Merge    Mergemod.dll version 2.0 or later.
IMsmMerge::Merge      All Mergemod.dll versions.

Syntax

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

Parameters

Feature [in]

The name of a feature in the database. A LPCWSTR can be used in place of a BSTR.

RedirectDir [in]

The key of an entry in the Directory table of the database. A LPCWSTR can be used in place of a BSTR. This parameter can be null or an empty string.

Return Value

The Merge function returns the following values.

Remarks

This function executes a merge of the current database and current module. The root of the module's directory tree is redirected to the location given by RedirectDir. 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 can be retrieved using the get_Errors function. Errors and informational messages are posted to the current log file.

Note that the Merge function 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.

Once the merge is complete, components in the module are attached to the feature identified by Feature. This feature must already exist and is not created.

The module can be attached to additional features using the Connect function. Note that calling the Connect function 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 not saved to disk unless the CloseDatabase function is called with bCommit set to TRUE.

Requirements

See Also

Merge Module Automation

Send comments about this topic to Microsoft

Build date: 8/13/2009