Command Reference

Modify INI File

Modifies an INI file.

Action ID: 18
Action Category: INI Files

Settings

INI file Action

The action to perform on the INI file:

File name

The name of the INI file.

Section

The name of the INI file section to operate on.

Value name

The name of the INI file value to modify.

Value data

The data to write to the INI file value (i.e., the data to store in the INI file).

Return Values

Value
(%LastErrorNum%)

Simple Message
(%LastErrorMsg%)

Simple Message
(%LastErrorMsg%)

0 (OK)

 

 

1

Could not modify INI file.

Could not set value.
<<File name [Section] - Value name = Value data>>

2

Could not modify INI file.

Could not delete value.
<<File name [Section] - Value name>>

3

Could not modify INI file.

Could not delete section.
<<File name [Section]>>

Example

In this example, we will write the registered user's name into a custom INI file named settings.ini.

Note: %AppDir% and %RegOwner% are both built-in variables.

INI file Action: Set Value
Filename: %AppDir%\settings.ini
Section: User Info
Value name: Name
Value data: %RegOwner%

 

See Also: Alphabetical List of Actions, Categorical List of Actions, On Error tab