IniLocator Table

The IniLocator table holds the information needed to search for a file or directory using an .ini file or to search for a particular .ini entry itself. The .ini file must be present in the default Microsoft Windows directory.

The IniLocator table has the following columns.

Column Type Key Nullable
Signature_ Identifier Y N
FileName FileName N N
Section Text N N
Key Text N N
Field Integer N Y
Type Integer N Y

 

Columns

Signature_

An external key into the first column of the Signature table. The Signature_ represents a unique signature and is also the external key into column one of the Signature table. If this signature is present in the Signature table, then the search is for a file. If this key is absent from the Signature table, and the value of the Type column is msidbLocatorTypeRawValue, the search is for the .ini entry specified by the IniLocator table. Otherwise the search is for a directory specified by the IniLocator table.

FileName

The .ini file name.

Section

Section name within the .ini file.

Key

Key value within the section.

Field

The field in the .ini line. If Field is Null or 0, then the entire line is read. This must be a non-negative number.

Type

A value that determines whether the .ini value is a file location, a directory location, or raw .ini value.

The following table lists valid values. If absent, Type is set to be 1.

Constant Hexadecimal Decimal Description
msidbLocatorTypeDirectory 0x000 0 A directory location.
msidbLocatorTypeFileName 0x001 1 A file location.
msidbLocatorTypeRawValue 0x002 2 A raw .ini value.

 

Remarks

This table is used with the AppSearch Table.

This table's columns are generally not localized. If an author decides to search for products in multiple languages, then there can be a separate entry included in the table for each language.

Associated localized text for progress display or logging is specified in the ActionText table.

See Searching for Existing Applications, Files, Registry Entries or .ini File Entries.

Validation

ICE03
ICE06