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

---

The "RemoveFile" Command

This command can be used to to populate the "RemoveFile" table.

It can be useful to overcome ICE validation errors if you create subdirectories for user shortcuts or you may wish to completely remove a directory on uninstall (including any created log files etc).

This command is takes the following parameters:

• File Mask (positional)
  This is the file mask of the file(s) to be deleted in the specified directory. It defaults to "" which means that the directory will be deleted if it is empty. The value should not include a directory or drive component but can contain normal wildcard characters such as "*" or "?".

  The value is assumed to be an 8.3 formatted wildcard unless you supply both short and long formats ("8.3|long format").

  I can only assume "*.*" on a directory followed by "" will clear a directory which contains files. Microsoft do not document this (that is do they order their deletions to delete files before folders etc).

• Dir (required)
  This is either the name of a property or a directory which indicates the directory being removed.

• Component (optional)
  This is the name of a component, if not supplied and if this command is nested between "component" and "/component" commands then the name of the "current" component is used. The component's attributes control installation and uninstallation conditions and behaviour.

• Mode (optional)
  This controls when the items are removed, valid options are:
  • INSTALL
  • UNINSTALL
  • INSTALL_AND_UNINSTALL

  The default for this parameter can be set via the DEFAULT_REMFILE_INSTALLMODE macro. The default value is "UNINSTALL".

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

EXAMPLES

;--- Doco -------------------------------------------------------------------
<$DirectoryTree Key="SCDIR_MAKEMSI" Dir="[ProgramMenuFolder]\MakeMSI Tool">
<$Component "DocoMAKEMSI" Create="Y" Directory_="INSTALLDIR">
   <$RemoveFile DIR="SCDIR_MAKEMSI">
   <$File Source="OUT\DOCO\MakeMsi.chm" Comment='MAKEMSI documentation.' KeyPath="Y">
   #(
       <$Shortcut
                   Dir="SCDIR_MAKEMSI"
               Feature="<$COMPANY_COMPLETE_FEATURE>"
                 Title="MakeMsi|MAKEMSI Documentation"
           Description="Documents the MAKEMSI tool"
       >
   #)
<$/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). Tuesday August 19 2008 at 7:04pm Visit MAKEMSI's Home Page