Merge.CreateSourceImage method

The CreateSourceImage method of the Merge object allows the client to extract the files from a module to a source image on disk after a merge, taking into account changes to the module that might have been made during module configuration. The list of files to be extracted is taken from the file table of the module during the merge process. The list of files consists of every file successfully copied from the file table of the module to the target database. File table entries that were not copied due to primary key conflicts with existing rows in the database are not a part of this list. At image creation time, the directory for each of these files comes from the open (post-merge) database. The path specified in the Path parameter is the root of the source image for the install. fLongFileNames determines whether or not long file names are used for both path segments and final file names. The function fails if no database is open, no module is open, or no merge has been performed.

Syntax

Merge.CreateSourceImage(
  Path,
  fLongFileNames,
  pFilePaths
)

Parameters

Path

The path of the root of the source image for the install.

fLongFileNames

fLongFileNames determines whether or not long file names are used for both path segments and final file names.

pFilePaths

This is a list of fully qualified paths for the files that were successfully extracted.

Return value

This method does not return a value.

Remarks

Any files in the destination directory with the same name are overwritten. The path is created if it does not already exist.

C++

See CreateSourceImage function.

Requirements

Requirement Value
Version
Mergemod.dll 2.0 or later
Header
Mergemod.h
DLL
Mergemod.dll