ISWiProductConfig Object

InstallShield 2024 » Automation Interface

Project: This information applies to the following project types:

• Basic MSI
• InstallScript
• InstallScript MSI
• InstallScript Object
• Merge Module

InstallScript and InstallScript Object projects contain only one element in ISWiProductConfigs; it is named Media.

Only some of the members of ISWiProductConfig apply to InstallScript and InstallScript Object projects.

ISWiProductConfig represents a product configuration in the Releases view of the InstallShield user interface. You can retrieve a configuration by specifying an item in the ISWiProductConfigs collection.

Members

ISWiProductConfig Object Members

Name

Project

Type

Description

AddRelease 

Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module

Method

Adds a release to the current product configuration.

ArchitectureValidation

Basic MSI, Merge Module

Read-Write Property

Set this property to one of the following values to indicate what type of build-time architecture validation you want to perform:

• epvtLenient (0)—Lenient architecture validation, which is the default type of validation, does not trigger build errors or warnings if the architecture that the Template Summary property specifies does not match the architecture for one or more of the product files or the custom action files that are being included in the release.
• epvtStrict (1)—Strict validation may trigger build errors and warnings if the architecture that the Template Summary property specifies does not match the architecture for one or more of the product files or custom action files that are being included in the release.

The value of this property also influences whether InstallShield includes 32-bit or 64-bit versions of the built-in InstallShield custom action DLLs.

To learn more, see Selecting the Appropriate Type of Architecture Validation for Builds.

ConfigFlags

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets a string that contains the release flags that you want to use to filter your features. Separate multiple flags with a comma.

DeleteRelease 

Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module

Method

Deletes the specified release from the current product configuration.

GeneratePackageCode

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Set this property to True to generate a new package code for every release you build under this product configuration.

If this property is not specified or set to False, then the existing package code under the product configuration is used. However, the Summary Information Stream's package code is used if you have not specified one here.

ISWiReleases 

Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module

Collection

Contains all of the releases belonging to this product configuration.

MSIPackageFileName

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets the value of the MSI Package File Name setting of the current product configuration.

Name

Basic MSI, InstallScript, InstallScript MSI, InstallScript Object, Merge Module

Read-Only Property

Returns the name of the current product configuration.

PackageCode

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets a string GUID for the package code that is built into this product configuration's releases. Neither the package code you enter in this property nor the Summary Information Stream's package code is used if you set the GeneratePackageCode property, above, to True.

ProductCode

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets a string GUID for the product code that is built into this product configuration's releases.

Note:The GUID must be surrounded by braces{12345678-1234-1234-1234-1234567890AB}, for example.

ProductName

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets the product name that is built into this product configuration's releases.

ProductVersion

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets a string that contains the product's version number, which overrides the Product Version property for every release you build under this product configuration.

SetupFileName

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets the value of the Setup File Name setting for the current product configuration.

Setup64bitLauncher

Basic MSI

Read-Write Property

Gets or sets the value of the 64-Bit Setup Launcher setting for the current product configuration. The possible values are:

• TRUE - to 64-bit Setup Launcher.
• FALSE - to 32-bit Setup Launcher.

Subject

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets the value of the Subject setting for the current product configuration.

Title

Basic MSI, InstallScript MSI, Merge Module

Read-Write Property

Gets or sets the value of the Title setting for the current product configuration.

UpgradeCode

Basic MSI, InstallScript MSI

Read-Write Property

Gets or sets the resulting setup package's Upgrade Code property.

Applies To

• ISWiProject