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 |
|---|---|
|
Opens a database to use as the merge target. |
|
|
Opens a merge module for use as the merge source. |
|
|
Closes the current database. |
|
|
Closes the current module |
|
|
Opens a log file. |
|
|
Closes the current log file. |
|
|
Logs a string to the current log file. |
|
|
Returns a collection of all errors from the most recent merge operation. |
|
|
Returns a collection of all unsatisfied dependencies in the database. |
|
|
Merges the current module into the current database. |
|
|
Connects the components in a module to the specified feature. |
|
|
Extracts the embedded CAB of a Merge Module to a disk file. |
|
|
Creates a source image of the Merge Module beneath the specified path. |
|
|
Merges the current module into the current database. |
|
|
Creates a source image of the Merge Module beneath the specified path. |
|
|
Returns a collection of configurable items in the database. |
|
|
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 |
|---|---|---|
| Read-only | Returns a collection of configurable items in the database. |
|
| Read-only | Returns a collection of all unsatisfied dependencies in the database. |
|
| 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
© 2009 Microsoft Corporation. All rights reserved.