IMsmMerge2 interface

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.

Members

The IMsmMerge2 interface inherits from the IDispatch interface. IMsmMerge2 also has these types of members:

Methods

The IMsmMerge2 interface has these methods.

MethodDescription
CloseDatabase

Closes the current database.

CloseLog

Closes the current log file.

CloseModule

Closes the current module

Connect

Connects the components in a module to the specified feature.

CreateSourceImage

Extracts files from a module to a source image on disk after a merge, with configuration changes.

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.

ExtractFilesEx

Creates a source image of the Merge Module beneath the specified path.

get_ConfigurableItems

Returns a collection of configurable items in the database.

get_Dependencies

Returns a collection of all unsatisfied dependencies in the database.

get_Errors

Returns a collection of all errors from the most recent merge operation.

Log

Logs a string to the current log file.

Merge

Merges the current module into the current database.

MergeEx

Merges the current module into the current database.

OpenDatabase

Opens a database to use as the merge target.

OpenLog

Opens a log file.

OpenModule

Opens a merge module for use as the merge source.

 

Properties

The IMsmMerge2 interface has these properties.

PropertyDescription

ConfigurableItems

Returns a collection of configurable items in the database.

Dependencies

Returns a collection of all unsatisfied dependencies in the database.

Errors

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft