MAKEMSI quickly and reliably creates MSI files in a non-programmatic way\Source CodeCommandsIni

---

The "Ini" Command

This command is used to define a single INI file update and must be used within a particular "section" of the file (see "IniSection").

The macro takes these parameters:

• INI Key Name (positional)
  This is the name of the entries "Key" within the section. The value will be assigned to this Key.

• [*]Value (required)
  This is the formatted value to be assigned.

  You should use "*VALUE" if you have a VBSCRIPT expression which resolves to a string (use "cstr()" if you get a type mismatch).

  Windows Installer does not support this value being empty, MAKEMSI can be configured to display an error message but by default it will reference a non-existing property to obtain the same effect. This conversion is only performed for literals.

• How (optional)
  This defines how this entry should be handled.

  1. ADD_OR_UPDATE
     Create or update an INI entry.

  2. ADD_ONLY
     Only create an INI entry (don't touch existing entries).

  3. ADD_OR_APPEND
     Create or append to an INI entry.

  The default for this parameter can be set via the DEFAULT_INI_HOW macro. The initial value is "ADD_OR_UPDATE".

• RowKey (optional)
  You may wish to set up a specific key to the row in the "IniFile" table, if you don't choose one a unique key will be generated for you.

• Component (optional)
  If this parameter is not specified then the component specified on the "IniFile" command will be used. If supplied and blank then the "current" component will be used. The component's attributes control installation and uninstallation conditions and behaviour.

  The most likely reason to override the component would be because the entry requires different conditions for installation.

• Doco (optional)
  Should ini file information is placed into the generated HTML report (Y/N)?

  The default for this parameter can be set via the DEFAULT_INI_DOCO macro. The initial value for this is "Y".

EXAMPLE

<$Component "INI" Create="Y" Directory_="INSTALLDIR" LM="Y">
   <$IniFile "Dennis.INI" DIR="C:\DBAREIS\PROJECTS\Win32\MakeMsi\OUT">
       <$IniSection "Section1">
           <$Ini "Key11" Value="Value11">
           <$Ini "Key12" Value="Value12">
       <$/IniSection>
       <$IniSection "Section2">
           <$Ini "Key21" Value="Value21">
           <$Ini "Key22" Value="Value22">
       <$/IniSection>
   <$/IniFile>
<$/Component>

Please email me any feedback, additional information or corrections. See this page online (look for updates) MAKEMSI© is (C)opyright Dennis Bareis 2003-2008 (All rights reserved). Sunday July 06 2008 at 11:25am Visit MAKEMSI's Home Page