Update INI Fields

The Update INI Fields section replaces, adds, and deletes fields in the value of an INI entry. Unlike an Update INI File section, an Update INI Fields section replaces, adds, or deletes portions of a value in an INI file entry rather than the whole value. The section name, update-inifields-section-name, must appear in the UpdateIniFields item in an Install section of the INF file.

[update-inifields-section-name]
ini-file,ini-section,profile-name,[old-field],[new-field],[flags]
.
.
.
 

ini-file

Name of the INI file containing the entry to change. For more information about specifying the INI filename, see Update INI File Section.

ini-section

Name of the INI file section containing the entry to change.

profile-name

Name of the entry to change.

old-field

Field value to delete.

new-field

Field value to add, if it does not exist.

flags

Specifies whether to treat the old-field and new-field arguments as though they have a wild card character. The parameter specifies which separator character to use when appending a new field to an INI file entry. The flags argument can be any of the following values.

Bit	Value	Meaning
0	0	(Default) Treat the asterisk (*) character literally and not as a wild card character when matching fields .
0	1	Treat the asterisk (*) character as a wild card character when matching fields.
1	0	(Default) Use a blank ( ) as a separator when adding a new field to an entry.
1	1	Use a comma (,) as a separator when adding a new field to an entry.

The setup functions remove any comments in the INI file line because they might not be applicable after changes. When looking for fields in the line in the INI file, the setup functions search for spaces, tabs, and commas as field delimiters. However, a space is used as the separator when the new field is appended to the line.

See Also

Overview, INF File Format Reference