The IMsmMerge interface and the IMsmMerge2 interface provide interfaces to the Merge object.The IMsmMerge2 interface provides a way for the client merge tool to utilize the new configurable-module functionality. Mergemod.dll provides access to the extended functionality at build time through a second version of the existing CLSID. This CLSID supports existing functionality available through the IMsmMerge interface, but the default interface on the object (and the associated dual interface) is the IMsmMerge2 interface instead of the IMsmMerge interface.

Requesting this interface does not commit the tool to using the new functionality. The interface supports both the standard and the "Ex" versions of the appropriate interface calls.

The Merge object provides access to other top-level objects. A Merge object must be created before loading the automation support required by COM to access the functions in Mergemod.dll.

Methods

The IMsmMerge2 interface inherits the methods of the IDispatch interface.

In addition, IMsmMerge2 defines the following methods.

Method	Description
OpenDatabase	Opens a database to use as the merge target.
OpenModule	Opens a merge module for use as the merge source.
CloseDatabase	Closes the current database.
CloseModule	Closes the current module
OpenLog	Opens a log file.
CloseLog	Closes the current log file.
Log	Logs a string to the current log file.
get_Errors	Returns a collection of all errors from the most recent merge operation.
get_Dependencies	Returns a collection of all unsatisfied dependencies in the database.
Merge	Merges the current module into the current database.
Connect	Connects the components in a module to the specified feature.
ExtractCAB	Extracts the embedded CAB of a Merge Module to a disk file.
ExtractFiles	Creates a source image of the Merge Module beneath the specified path.
MergeEx	Merges the current module into the current database.
ExtractFilesEx	Creates a source image of the Merge Module beneath the specified path.
get_ConfigurableItems	Returns a collection of configurable items in the database.
CreateSourceImage	Extracts files from a module to a source image on disk after a merge, with configuration changes.

 

Properties

The IMsmMerge2 interface defines the following properties.

Property	Access type	Description
ConfigurableItems	Read-only	Returns a collection of configurable items in the database.
Dependencies	Read-only	Returns a collection of all unsatisfied dependencies in the database.
Errors	Read-only	Returns a collection of all errors from the most recent merge operation.

 

Requirements

Version	Mergemod.dll 2.0 or later
Header	Mergemod.h
DLL	Mergemod.dll
IID	IID_IMsmMerge2 is defined as 351A72AB-21CB-47ab-B7AA-C4D7B02EA305

Send comments about this topic to Microsoft

Build date: 8/13/2009