CreateInstallationInfo
InstallShield 2024 » InstallScript Language Reference
In an event-based script, the CreateInstallationInfo function is called automatically after the First UI Before event. It uses the system variables IFX_KEYPATH_PRODUCT_INFO and IFX_PRODUCT_KEY to create an application information key and a per application paths key for the program you are installing. The application information key is created immediately as a result of calling CreateInstallationInfo. The per application paths key is not created until a subsequent call to RegDBSetItem sets a [Path] or [DefaultPath] value under that key.
CreateInstallationInfo provides the product name for display in the Welcome dialog as well as the company name, product name, and version number that MaintenanceStart uses to initialize the uninstallation log file. MaintenanceStart will fail if CreateInstallationInfo is not called before it in the script.
Call CreateInstallationInfo only once in a setup. If you are launching multiple installations using DoInstall, each installation can of course have its own call to CreateInstallationInfo.
CreateInstallationInfo is a special registry-related function, designed to work with certain predefined registry keys. For more information, see Special Registry-Related Functions.
Note:The InstallScript engine currently does not support writing or reading Add or Remove Programs information for a product in the 64-bit part of the registry. Therefore, using the REGDB_OPTION_WOW64_64KEY option with the REGDB_OPTIONS system variable is not supported for this registry function. Enabling the REGDB_OPTION_WOW64_64KEY option has no effect on where registry entries are created by this function.
Syntax
CreateInstallationInfo ( );
Parameters
None
Return Values
|
Return Value |
Description |
|
0 |
Indicates that the function was successful. |
|
< 0 |
Indicates that the function failed to create one or more of the registry keys You can obtain the error message text associated with a large negative return value—for example, -2147024891 (0x80070005)—by calling FormatMessage. |
Additional Information
| • | You must call CreateInstallationInfo before calling RegDBSetItem or RegDBGetItem. See the descriptions of those functions for further information. |
| • | The per application paths key is not actually created until RegDBSetItem is called to set a value under that key. |
| • | CreateInstallationInfo no longer fails when IFX_COMPANY_NAME, IFX_PRODUCT_NAME, or IFX_PRODUCT_VERSION are empty. CreateInstallationInfo fails if a remote registry is connected, IFX_KEYPATH_PRODUCT_INFO is empty, or the application information registry key cannot be created. |
See Also