The OpenModule method opens a Windows Installer merge module in read-only mode. A module must be opened before it can be merged with an installation database. For more information, see the OpenModule method of the Merge object.

IMsmMerge2::OpenModule    Mergemod.dll version 2.0 and later.
IMsmMerge::OpenModule      All Mergemod.dll versions.

Syntax

C++HRESULT OpenModule(
  [in]  BSTR FileName,
  [in]  short Language
);

Parameters

FileName [in]

Fully-qualified file name that points to a merge module. A LPCWSTR can be used in place of a BSTR.

Language [in]

A language identifier (LANGID).

Return Value

The OpenModule function returns the following values.

Remarks

This function opens the merge module in read-only mode (MSIDBOPEN_READONLY), and excludes other programs from writing to the merge module until the CloseModule function is called. A merge module must be opened before it can be merged.

The installer attempts to open the module in the language specified by Language or in any more general language. For example, if 1033 is specified by the Language value, a module with a default language of 1033, 9, or 0 is opened in its default language. A Language value of 9 opens modules with a default language of 9 or 0. If the default language of the module does not meet the specified requirements, an attempt is made to transform the module into the requested language. If that fails, the installer attempts to transform the module into increasingly general languages, all the way to language neutral. If none of the transforms succeed, the module fails to open. In this case, an error is added to the error list of type msmErrorLanguageUnsupported and the function returns ERROR_INSTALL_LANGUAGE_UNSUPPORTED as HRESULT.

If there is an error transforming the module to the desired language, an error is created of type msmErrorLanguageFailed and the function returns ERROR_INSTALL_TRANSFORM_FAILURE as HRESULT.

For more information, see the Type property of the Error object.

Opening a merge module clears any errors that have not already been retrieved.

Requirements

See Also

Merge Module Automation

Send comments about this topic to Microsoft

Build date: 8/13/2009