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

---

The "DirectoryTree" Command

This command takes a directory specification in a fairly user friendly format and defines and possibly creates this directory entry in the MSI "Directory" table.

Directories created by this command are created via the MakeMsi "Directory" command.

The macro takes these parameters:

• Key (required)
  This allows you to specify what the name of the very last component of the directory is called (e.g. what the key for "CCC" in the directory "C:\AAA\BBB\CCC" would be).

• DIR (required)
  This is the directory tree you wish to define or create (when the MSI is installed). Please see the "Directory Tree Specification" section for more details.

• Make (optional)
  To add this directory to the MSI "CreateFolder" table you should pass "Y" (any other value means "N" - the default value).

  This is required to create an empty folder that may/will contain no files (maybe a "log" directory).

  You do not need to create folders which contain files as folders are automatically created when files are installed.

• Remove (optional)
  To add this directory to the MSI "RemoveFile" table table (for removal when the component is uninstalled/removed) you should pass "Y" (the default is "N").

  You will generally use this parameter to remove "ICE64" validation errors which indicate that the folder may not be removed on uninstall (the folder will not be removed if files exist). on If you used the "MAKE" parameter it will use the same component otherwise it works the same as the "MAKE" parameter except that a component will never be created for you.

• Component (optional)
  This parameter is ignored unless either "MAKE=Y" or "REMOVE=Y" (the only time a component is required).

  If not supplied then the "current" component information (see "Component" command) is used. If required (no current component), a component will be created.

• Change (optional)
  If a non-blank parameter is passed then this is the name of an existing feature that should be associated with this directory. The final install directory will be able to be updated by the user at install time ("Browse" button). The value "\" is replaced with the value of the current "root" feature while "." is replaced with the value of the "current" feature. Of course an error message is created if there is no "current" feature.

• PrimaryFolder (optional)
  You should pass "Y" for this parameter if the directory represents the "primary folder". The MSI properties "ARPINSTALLLOCATION" and "PRIMARYFOLDER" will be set.

• Access (optional)
  You can use this parameter to indicate that the entry requires one or more (space separated) special user permissions which have previously been defined using an "Access" command.

  Note that the directory key must be specified in the "CreateFolder" table table otherwise you should get validation errors and it won't work. You can use the "MAKE" parameter to add the info to the table.

• Any others (optional)
  Any other parameters are ignored unless "MAKE=Y" and we are creating the component, otherwise it should be a valid parameter for the "Component" command.

If you find that varying one directory effects another's location then you should read the "Altering one Directory also effects Others" section.

EXAMPLES - Create Empty Folder

Note that in the following example an empty folder is not removed on uninstallation, use the "REMOVE" parameter if this is required:

<$Component "CreateEmptyFolder" Create="Y" Directory_="EMPTYDIR">
    <$DirectoryTree Key="EMPTYDIR" Dir="c:\EmptyDirectory" MAKE="Y">
<$/Component>

EXAMPLES - Other

<$DirectoryTree Key="INSTALLDIR1" DIR="C:\A\B\C\D\E\F\G\InstallationDirectory"> ;;C: forced! (BY DEFAULT) - can be overriden from install command line though...
<$DirectoryTree Key="INSTALLDIR2" DIR="[ProgramFilesFolder]\x\y\z\InstDir2">    ;;Tree starts at "ProgramFilesFolder"
<$DirectoryTree Key="INSTALLDIR3" DIR="C:\Program Files\InstDir3">              ;;Because of preconfigured mapping will convert to use "ProgramFilesFolder"!
<$DirectoryTree Key="INSTALLDIR4" DIR="C:\Program Files\AN83NAME.1|ALongDirectoryNameForWhichIHaveSuppliedASpecific_8.3_Name">  ;;Specify a specific 8.3 name

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). Saturday May 28 2022 at 3:11pm Visit MAKEMSI's Home Page