Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Use conditions
  • Error codes
  • Closing the archive
  • Number of parts
  • Actions that can be performed on a multi-part archive
  • The multi-part archive is found on diskettes
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Merges the different sub-archives found in a multi-part archive to create a single-part archive.
Versions 18 and later
Windows This function now supports the 7z format.
New in version 18
Windows This function now supports the 7z format.
Windows This function now supports the 7z format.
Reports and Queries
MonArchive is zipArchive
// Ouverture d'une archive multi-parties
ResOuvreArchive = zipOpen(MonArchive, "C:\MesArchives\Archive.zip")
IF ResOuvreArchive = 0 THEN
// Regroupement des sous-archives d'une archive multi-parties
ResRegroupe = zipMerge(MonArchive,...
<Result> = zipMerge(<Archive> , <Archive destination> [, <Gauge management>])
<Result>: entier
  • 0 if the sub-archives have been merged,
  • an error code (value greater than 0) otherwise. For more details on these error codes, see the Remarks.
<Archive>: Character string (with quotes) or zipArchive variable
Name of archive to use.
This name can correspond to:
<Archive destination>: Character string (with quotes)
Physical path of new single-part archive (up to 260 characters). This path must contain the name of single-part archive to create. If the extension (.WDZ or .ZIP) is not specified, the extension corresponds to the initial extension. You have the ability to specify the same path and name as the split archive: the split archive will be overwritten by the merged archive.
<Gauge management>: Optional character string (with or without quotes)

Use conditions

Remark: The merge operation can be performed if:
  • The archive exists (archives are created using zipCreate).
  • The archive is a multi-part archive.
  • The archive is not in "CAB" format, in "RAR" format or in "TAR" or TARGZ" format.

    Error codes

    The following error codes are returned:
    • 1: The path passed as parameter does not exist.
    • 2: Access denied: the user has no sufficient rights.
    • 3: The archive is corrupted.
    • 6: The sub-archives are not arranged in order.
    The message corresponding to the error code is returned by zipMsgError.

    Closing the archive

    Once zipMerge has been used on an archive, this archive is not closed. You must use:
    • zipClose to close the multi-part archive.
    • zipOpen to open the new single-part archive.

    Number of parts

    The zipNbPart function allows you to find out the number of sub-archives in a multi-part archive.

    Actions that can be performed on a multi-part archive

    Some archiving functions can only be used with single-part archives (add and delete files, create a self-extracting executable, etc.). To perform these operations, it is sufficient to group the sub-archives (zipMerge) to obtain a single-part archive.
    From a multi-part archive, you can only:
    Reports and Queries

    The multi-part archive is found on diskettes

    If the different sub-archives are found on diskettes, the next diskette will be automatically requested via a dialog box when the sub-archives are merged. An error will occur if the merge operation is canceled by the user (the multi-part archive is not found).
    Business / UI classification: Business Logic
    Component: wd270zip.dll
    Minimum version required
    • Version 9
    This page is also available for…
    Click [Add] to post a comment