MSI Factory

An INI file search allows you to read a value from an INI file located in the Windows folder on the user's system.

Property

Property ID:

The name that uniquely identifies the property. The vaue read from the INI file will be stored in this property if it is found. If not found, the property will contain the Default value below.

Default value:

The default value of the property. This value will be assigned to the property if the INI value cannot be located. Note that you cannot set a property with another property. The literal value that you enter will be assigned to the property.

Hide from log output

If checked, the property is not logged during installation. Used to prevent the installer from displaying passwords or other confidential information in the log file.

Save value during admin installation

If checked, the property is saved during administrative installation. When users install from the administrative image, the installation uses the saved values of the properties, rather than the values in the .msi file.

Allow transfer to server side (property is secure)

If checked, the property can be passed to the server side when doing a managed installation with elevated privileges.

Include in compliance check

If checked, the install will abort if the INI value cannot be read. It has the effect of putting this search into the CPPSearch table as well as the AppSearch table.

INI File

Filename:

The name of the INI file. For example, "settings.ini." Remember that the INI file must be located in the user's Windows folder. The INI file search will not work for INI files in any other folder.

Section:

The section name in the INI file.

Key:

The name of the key in the INI file section. This is the text to the left of the "=" in the INI file entry.

Field:

The field to read in the INI file value. Leave as "0" to read the entire line (all text right of the "="). If this is greater than 0, it is the index of a comma-separated value in the INI file line. For example:

The INI file value that we are reading is:

Values=abc,def,ghi

Setting the field to "0" returns: abc,def,ghi

Setting the field to "1" returns: abc

Setting the field to "3" returns: ghi

More Information

MSDN Online: AppSearch Action

MSDN Online: AppSearch Table

MSDN Online: CCPSearch Action

MSDN Online: CCPSearch Table

MSDN Online: IniLocator Table

MSDN Online: Searching for Existing Applications, Files, Registry Entries or .ini File Entries

WiX Help File: IniFileSearch Element

WiX Help File: Property Element

Learn More: Indigo Rose Software - MSI Factory - Buy Now - Contact Us