SetInstallationInfo

InstallShield 2016 ยป InstallScript Language Reference

The SetInstallationInfo function sets the values of the system variables IFX_COMPANY_NAME, IFX_PRODUCT_NAME, IFX_PRODUCT_VERSION, and IFX_PRODUCT_KEY. SetInstallationInfo specifies this information for use by CreateInstallationInfo, which in an event-based script is called in the default OnShowUI event handler code to create an application information key and a per application paths key for the program you are installing.

SetInstallationInfo is a special registry-related function, designed to work with certain predefined registry keys. For more information on special registry-related functions, see Special Registry-Related Functions.

Syntax

SetInstallationInfo ( szCompany, szProduct, szVersion, szProductKey );

Parameters

SetInstallationInfo Parameters

Parameter

Description

szCompany

Specifies the company name. CreateInstallationInfo uses szCompany to create a \<company> key under the HKEY_LOCAL_MACHINE\Software key in the registry.

szProduct

Specifies the name of the product to be installed. CreateInstallationInfo uses szProduct to create a \<product> key under the HKEY_LOCAL_MACHINE\Software\<company> key in the registry. The value in szProduct is also inserted into the first paragraph of message text in the Welcome dialog.

szVersion

Specifies the version number of the product. CreateInstallationInfo uses szVersion to create a \<version> key under the HKEY_LOCAL_MACHINE\Software\<company>\<product> key in the registry. Together, the \<company> key (szCompany), the \<product> key (szProduct), and the \<version> key (szVersion) are referred to as the application information key. The application information key is created immediately upon calling CreateInstallationInfo.

szProductKey

Specifies the name of the application's main executable file. If your product uses several executables, specify the executable that best represents the product. CreateInstallationInfo uses szProductKey to create a per application paths key under the key HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\App Paths. The per application paths key is not actually created in the registry until you call RegDBSetItem to create a value name and value pair under the key.

Return Values

This function always returns 0.

See Also