RemoveIniValues Action

[This is preliminary documentation and subject to change.]

The RemoveIniValues action deletes .ini file information that the application needs to delete from .ini files. The deletion of the information is gated by the Component table. A .ini value is deleted if the corresponding component has been set to be installed either locally or run from source.

Database Tables Queried

RemoveIniFile Table

Component Table

RemoveIniFile.FileName The .ini file name in which the value is to be deleted.
RemoveIniFile.Directory_ Directory for the .ini file. This is a foreign key into the Directory table.
RemoveIniFile.Section The .ini file section.
RemoveIniFile.Key The .ini file key under the section.
RemoveIniFile.Value Value to be deleted.
RemoveIniFile.Action How the value is to be deleted. For more information, see the IniFile table.
Component.Action Action field from the Component table for the component record corresponding to RemoveIniFile.Component_. Must be either:

iisLocal = 1: Item is to be installed locally (item is currently uninstalled or installed from run from source).

iisSource = 2: Item is to be installed from run from source (item is currently uninstalled or installed locally).


The RemoveIniValues action also removes the .ini information that the application writes to the system registry with the WriteIniValues action. A .ini value is deleted from the corresponding .ini file if the corresponding component has been set to be uninstalled.

IniFile Table

Component Table

IniFile.FileName The .ini file name in which the value is written.
IniFile.Directory_ Directory for the .ini file. This is a foreign key into the Directory table.
IniFile.Section The .ini file section.
IniFile.Key The .ini file key under the section.
IniFile.Value Value that is written.
IniFile.Action How the value is written. For more information, see the IniFile table. The RemoveIniValues action deletes the value that is written by reversing the IniFile.Action.
Component.Action The Action field from the Component table for the component record corresponding to IniFile.Component_. Must be:

iisAbsent = 0: Item is not installed.


Properties Used

None

Sequencing Restrictions

The InstallValidate action must be called before calling RemoveIniValues. If a WriteIniValues action is used, it must appear after RemoveIniValues.