share/InnoSetup/isfaq.htm

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html>
   3 <head>
   4 <title>Inno Setup FAQ</title>
   5 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
   6 <style type="text/css"><!--
   7 BODY {
   8         background: #ffffff;
   9         color: #000000;
  10         font: small verdana, arial, sans-serif;
  11 }
  12 H1, .xxbig {
  13         font: bold xx-large verdana, arial, sans-serif;
  14 }
  15 H2, .xbig {
  16         font: bold x-large verdana, arial, sans-serif;
  17 }
  18 H3, .big {
  19         font: bold large verdana, arial, sans-serif;
  20 }
  21 H4, .medium {
  22         font: bold medium verdana, arial, sans-serif;
  23 }
  24 PRE, TT {
  25         font: small "courier new", monospace;
  26 }
  27 LI {
  28         margin-top: 0.25em;
  29         margin-bottom: 0.25em;
  30 }
  31 P, UL {
  32         /* for paragraph spacing consistency between IE (6) and Mozilla (1.4) */
  33         margin-top: 1em;
  34         margin-bottom: 1em;
  35 }
  36 A:link {
  37         color: #274d99;
  38 }
  39 A:visited, A:active {
  40         color: #5a83d7;
  41 }
  42 --></style>
  43 </head>
  44 <body>
  45 <table width="100%" border="0" cellpadding="5" cellspacing="0">
  46    <tr>
  47    <td align="center" bgcolor="#264b99"><span class="xxbig"><font color="#FFFFFF">Inno Setup</font></span><br />
  48 <span class="big"><font color="#FFFFFF">Frequently Asked Questions</font></span></td>
  49    </tr>
  50 </table>
  51
  52
  53 <p>The <b>Inno Setup Frequently Asked Questions</b> contains supplemental information not found in the <a href="ishelp/" target="blank">documentation</a> or the <a href="iskb.php">Knowledge Base</a>.</p>
  54
  55 <h3>Functionality</h3>
  56 <ul>
  57 <li><a href="#lang">Translating Inno Setup's Text</a></li>
  58 <li><a href="#mbcs">Does it support MBCS (multi-byte character sets)?</a></li>
  59 <li><a href="#msi">Will it support Windows Installer in the future?</a></li>
  60 <li><a href="#setupicon">How do I change the icon of Setup.exe?</a></li>
  61 <li><a href="#conditional">Can Inno Setup do a conditional installation - for example, proceed only if a certain registry key or file exists?</a></li>
  62 <li><a href="#silent">Is it possible to do a silent install without using the /SILENT or /VERYSILENT command-line parameters?</a></li>
  63 <li><a href="#dirnamereg">Can Setup use the value of a registry entry as the default directory name?</a></li>
  64 </ul>
  65
  66 <h3>Problems</h3>
  67 <ul>
  68 <li><a href="#errorquotes">Compiler says "Mismatched or misplaced quotes on parameter"</a></li>
  69 <li><a href="#workingdir">My application can't find any of its files when it is started from the shortcut created by Setup. It works fine when I double-click the application's EXE in Explorer.</a></li>
  70 <li><a href="#appid">When I install a new version of my application without uninstalling the old version first, I get a second entry in Control Panel's <i>Add/Remove Programs</i>.</a></li>
  71 <li><a href="#corrupt">Why is the error message "The setup files are corrupted" displayed on some systems?</a></li>
  72 <li><a href="#noregserver">Setup gives the message "Unable to register the DLL/OCX: DllRegisterServer export not found"</a></li>
  73 <li><a href="#emptydirs">After uninstalling, the directories created during installation still exist.</a></li>
  74 <li><a href="#batchfile">I run a batch file in the [Run] section, but the window remains on the screen after it finishes executing. I'd like it to "close on exit."</a></li>
  75 <li><a href="#olddir">I've changed DefaultDirName in my script, yet when I run Setup it defaults to the directory I had before.</a></li>
  76 <li><a href="#twoicons">I have two [Icons] entries with the same Name, but only one of them gets installed.</a></li>
  77 <li><a href="#runwait">Setup isn't waiting for programs executed by [Run] entries to finish.</a></li>
  78 <li><a href="#missinglanguages">Some languages are missing on the <i>Select Setup Language</i> dialog, or it doesn't show up at all.</a></li>
  79 </ul>
  80
  81 <h3>Installation Tasks</h3>
  82 <ul>
  83 <li><a href="#urls">Creating Internet (URL) Shortcuts</a></li>
  84 <li><a href="#startin">Setting the "Start In" Field on a Shortcut</a></li>
  85 <li><a href="#assoc">Creating File Associations</a></li>
  86 <li><a href="#env">Setting Environment Variables</a></li>
  87 <li><a href="#closeonexit">Setting the "Close on Exit" Box on a Shortcut to an MS-DOS Program</a></li>
  88 <li><a href="#backup">Making Backups Before Replacing Files</a></li>
  89 <li><a href="#difffiles">Installing Different Files Depending on Windows Version</a></li>
  90 <li><a href="#perms">Settings Permissions on Files, Directories, or Registry Keys</a></li>
  91 <li><a href="#custom">My installation needs to do something that Inno Setup apparently doesn't have a feature for.</a></li>
  92 </ul>
  93
  94 <h3>How Do I Install...?</h3>
  95 <ul>
  96 <li><a href="#ocx">OCX Files</a></li>
  97 <li><a href="#vb">Visual Basic System Files</a></li>
  98 <li><a href="#vc">Visual C++ System Files (e.g. MFC)</a></li>
  99 <li><a href="#comctl32">COMCTL32.DLL</a></li>
 100 <li><a href="#bde">BDE (Borland Database Engine)</a></li>
 101 <li><a href="#mdac">MDAC, ADO, Jet, etc.</a></li>
 102 </ul>
 103
 104 <h3>Compatibility</h3>
 105 <ul>
 106 <li><a href="#oscompat">OS Compatibility</a></li>
 107 <li><a href="#ntsecur">Administrative Privileges</a></li>
 108 </ul>
 109
 110 <h3>Miscellaneous</h3>
 111 <ul>
 112 <li><a href="#limits">Are there any limits on how many files, etc. may be included in an installation?</a></li>
 113 <li><a href="#cancel">What exactly happens when the user clicks Cancel during an installation?</a></li>
 114 </ul>
 115
 116
 117
 118 <hr /><h2>Functionality</h2>
 119
 120 <h4><a name="lang">Translating Inno Setup's Text</a></h4>
 121 <blockquote>
 122 <p>Translating Inno Setup's text into another language does not require modifying the source code. Simply make a copy of the Default.isl file (included with Inno Setup) and start editing the text in it. (Do not directly edit the Default.isl file, otherwise your changes will be lost when you install a new Inno Setup version.) See the "[Messages] Section" topic in the Inno Setup help file for some important tips.</p>
 123 <p>Once you have finished creating the new .isl file, create a [Languages] section to tell the compiler to use it:</p>
 124 <p><tt>
 125 <b>[Languages]</b><br />
 126 <font color="blue">Name</font>: mytrans; <font color="blue">MessagesFile</font>: "compiler:MyTranslation.isl"
 127 </tt></p>
 128 <p>If you're using a version of Inno Setup prior to 4.0, use this instead:</p>
 129 <p><tt>
 130 <b>[Setup]</b><br />
 131 <font color="blue">MessagesFile</font>=compiler:MyTranslation.isl
 132 </tt></p>
 133 <p>There are many contributed translations available for download on the <a href="http://www.jrsoftware.org/is3rdparty.php">Inno Setup Third-Party Files</a> page, as well as a program to assist in editing the .isl file.</p>
 134 </blockquote>
 135
 136 <h4><a name="mbcs">Does it support MBCS (multi-byte character sets)?</a></h4>
 137 <blockquote>
 138 <p>Inno Setup 2.0.6 adds complete support for MBCS. It does lead byte checking on all filename and constant parsing, so it should no longer mistake trail bytes for backslashes ("\") or braces ("{").</p>
 139 <p>Versions prior to 2.0.6 did not include any special support for MBCS.</p>
 140 </blockquote>
 141
 142 <h4><a name="msi">Will it support Windows Installer in the future?</a></h4>
 143 <blockquote>
 144 <p>At the present time, there are no plans for a Windows Installer edition of Inno Setup. "Supporting" Windows Installer would likely involve a near-complete rewrite of the program.</p>
 145 </blockquote>
 146
 147 <h4><a name="setupicon">How do I change the icon of Setup.exe?</a></h4>
 148 <blockquote>
 149 <p>The installer's icon may be changed by setting the <tt>SetupIconFile</tt> [Setup] section directive. To set the uninstaller's icon, set <tt>UninstallIconFile</tt>.</p>
 150 </blockquote>
 151
 152 <h4><a name="conditional">Can Inno Setup do a conditional installation - for example, proceed only if a certain registry key or file exists?</a></h4>
 153 <blockquote>
 154 <p>Inno Setup 4 adds support for this through the new Pascal Scripting feature.</p>
 155 <p>Note: with earlier Inno Setup versions it was already possible to <a href="#difffiles">install different files depending on the Windows version</a>.</p>
 156 </blockquote>
 157
 158
 159 <h4><a name="silent">Is it possible to do a silent install without using the /SILENT or /VERYSILENT command-line parameters?</a></h4>
 160 <blockquote>
 161 <p>No, nor is such a feature planned (it would be abused). If it is your intention to keep user interaction to a minimum, use the Disable* [Setup] section directives.</p>
 162 </blockquote>
 163
 164 <h4><a name="dirnamereg">Can Setup use the value of a registry entry as the default directory name?</a></h4>
 165 <blockquote>
 166 <p>Yes. Use a {reg:...} constant in DefaultDirName. For example:</p>
 167 <p><tt><b>[Setup]</b><br />
 168 <font color="blue">DefaultDirName</font>={reg:HKLM\Software\My Program,Path|{pf}\My Program}<br />
 169 </tt></p>
 170 <p>See the "Constants" topic in the Inno Setup help file for more information on {reg:...} constants.</p>
 171 </blockquote>
 172
 173
 174
 175 <hr /><h2>Problems</h2>
 176
 177 <h4><a name="errorquotes">Compiler says "Mismatched or misplaced quotes on parameter"</a></h4>
 178 <blockquote>
 179 <p>This message is typically displayed if you try to embed a quote (") character in a parameter's data, but do not double it as required. Read the "Parameters in Sections" topic in the Inno Setup help file for more information.</p>
 180 </blockquote>
 181
 182 <h4><a name="workingdir">My application can't find any of its files when it is started from the shortcut created by Setup. It works fine when I double-click the application's EXE in Explorer.</a></h4>
 183 <blockquote>
 184 <p>Your application is most likely not specifying pathnames on the files it is trying to open, so it is expecting to find them in the current directory. Inno Setup by default does not set the "Start In" field on shortcuts its creates; this causes Windows to pick a directory itself, which usually won't be the directory containing your application.</p>
 185 <p>In virtually all cases, this is something that should be corrected at the application level. Properly designed GUI applications should not expect to be started from a particular directory; they should always specify full pathnames on files they open. In Delphi or C++Builder, for example, it's possible to get the full pathname of the directory containing the application EXE by calling: <tt>ExtractFilePath(ParamStr(0))</tt>. To get the full path of a file named "File.txt" in the application directory, use: <tt>ExtractFilePath(ParamStr(0)) + 'File.txt'</tt>.</p>
 186 <p>If for some reason you cannot fix this at the application level, you can tell Inno Setup to set the "Start In" field by adding "WorkingDir: {app}" to your [Icons] entries.</p>
 187 </blockquote>
 188
 189 <h4><a name="corrupt">Why is the error message "The setup files are corrupted" displayed on some systems?</a></h4>
 190 <blockquote>
 191 <p>This error message is displayed when a file pertaining to the installation (e.g., setup.exe, setup.1) has the wrong size, or part of a file fails a CRC check. It is not displayed for any other reason.</p>
 192 <p>If your installation is distributed over the internet and you're getting a lot of reports of this error, it could be that your web server is delivering partial files by dropping connections prematurely. Have the affected users check the size in the bytes of the file(s) they downloaded.</p>
 193 <p>If your installation is distributed via CD-ROM or floppy disk, it could be that the CD-ROM or floppy disk is bad, or possibly the drive is defective.</p>
 194 </blockquote>
 195
 196 <h4><a name="appid">When I install a new version of my application without uninstalling the old version first, I get a second entry in Control Panel's <i>Add/Remove Programs</i>.</a></h4>
 197 <blockquote>
 198 <p>This happens when you change AppId between versions, or if AppId is not specified, AppName. If you do that, Setup has no way of knowing that the two versions are of the same application, and thus will create a new entry in <i>Add/Remove Programs</i>. Additionally, a new uninstall log file (unins???.dat) will be created. The obvious solution for this is to not change AppId or AppName.</p>
 199 <p>If you must change AppName in a new version, set AppId to the value of AppId or AppName from the previous version.</p>
 200 </blockquote>
 201
 202 <h4><a name="noregserver">Setup gives the message "Unable to register the DLL/OCX: DllRegisterServer export not found"</a></h4>
 203 <blockquote>
 204 <p>This message normally means that you specified the "regserver" flag on a file that doesn't possess the ability to be registered. Remove the "regserver" flag from the [Files] entry and the message will go away.</p>
 205 </blockquote>
 206
 207 <h4><a name="emptydirs">After uninstalling, the directories created during installation still exist.</a></h4>
 208 <blockquote>
 209 <p>There are several reasons why a directory may not be removed:</p>
 210 <ul>
 211 <li>It already existed prior to installation. By default, the uninstaller plays it safe and doesn't remove directories that the installer didn't create.</li>
 212 <li>It contains files or subdirectories. Use [UninstallDelete] if you need the uninstaller to delete additional files/directories.</li>
 213 <li>A running process has the directory as its current directory.</li>
 214 </ul>
 215 <p>Note: In Inno Setup versions prior to 2.0.1, directories must be specified in either the [Dirs] or [UninstallDelete] sections for them to be deleted by the uninstaller. In newer Inno Setup versions, directories created by [Files] section entries will be deleted automatically by the uninstaller if they didn't exist prior to installation.</p>
 216 </blockquote>
 217
 218 <h4><a name="batchfile">I run a batch file in the [Run] section, but the window remains on the screen after it finishes executing. I'd like it to "close on exit."</a></h4>
 219 <blockquote>
 220 <p>From Tim Rude:<br />
 221 The simplest way to get a batch file to automatically close on exit is to clear the screen at the end of it using the CLS command.</p>
 222 <p><i>--- batch file 1 ---</i></p>
 223 <p><tt>
 224 @echo off<br />
 225 echo Hello World<br />
 226 echo This batch file does NOT close on exit
 227 </tt></p>
 228 <p><i>--- batch file 2 ---</i></p>
 229 <p><tt>
 230 @echo off<br />
 231 echo Hello World<br />
 232 echo This batch file DOES close on exit<br />
 233 cls
 234 </tt></p>
 235 </blockquote>
 236
 237 <h4><a name="olddir">I've changed DefaultDirName in my script, yet when I run Setup it defaults to the directory I had before.</a></h4>
 238 <blockquote>
 239 <p>At startup Setup looks in the registry to see if the same application was already installed previously, and if so, it will use the directory of the previous installation as the default directory presented to the user in the wizard. If you uninstall the application and run Setup again, it will use the new DefaultDirName setting. If you wish to disable this feature, set UsePreviousAppDir to "no".</p>
 240 </blockquote>
 241
 242 <h4><a name="twoicons">I have two [Icons] entries with the same Name, but only one of them gets installed.</a></h4>
 243 <blockquote>
 244 <p>Two files can't have the same name, and since shortcuts are files, two shortcuts therefore can't have the same name.</p>
 245 </blockquote>
 246
 247 <h4><a name="runwait">Setup isn't waiting for a program executed by a [Run] entry to finish.</a></h4>
 248 <blockquote>
 249 <p>First, make sure that you are <i>not</i> using the "nowait" or "waituntilidle" flags on the [Run] entry. These flags prevent Setup from waiting until the process completely terminates.</p>
 250 <p>If you aren't using those flags and it still doesn't seem to be waiting for the program to finish, then likely what is happening is that the EXE you're running is spawning some other process and then terminating itself immediately, causing Setup to think the program has finished. This is known to happen with older InstallShield-based installers (to work around it, try using the <a href="http://www.installshield.com/news/newsletter/0206-articles/LaunchIS5Setup.asp">/SMS switch</a>).</p>
 251 <p>A simple way to check if a program does that is to run "START /WAIT ProgramName.exe" from the command line, and see if you are returned to the command prompt before the program exits.</p>
 252 </blockquote>
 253
 254 <h4><a name="missinglanguages">Some languages are missing on the <i>Select Setup Language</i> dialog, or it doesn't show up at all.</a></h4>
 255 <blockquote>
 256 <p>You are using Non Unicode Inno Setup:</li>
 257 <p>Beginning with Inno Setup 4.2.2, languages specified in the [Languages] section that cannot be displayed under the active Windows ANSI code page are not listed in the <i>Select Setup Language</i> dialog. For example, Russian text can only be displayed properly if the active code page is 1251; if the user isn't running code page 1251 they will not see Russian as an option.</p>
 258 <p>On Windows XP, the active code page may be changed by going to <i>Regional and Language Options</i> in Control Panel, and setting <i>Language for non-Unicode programs</i> on the Advanced tab. On Windows 2000, the active code page may be changed by going to <i>Regional Options</i> in Control Panel, and clicking <i>Set default...</i>.</p>
 259 <p>If you are sure you're running in the correct code page and a language still isn't being listed, then most likely <tt>LanguageCodePage</tt> is set incorrectly inside the language's .isl file.</p>
 260 <p>If you would like to force all languages to be visible regardless of whether they can be displayed properly under the active code page, set the <tt>ShowUndisplayableLanguages</tt> [Setup] section directive (new in Inno Setup 5.1.7).</p>
 261 </blockquote>
 262
 263
 264
 265 <hr /><h2>Installation Tasks</h2>
 266
 267 <h4><a name="urls">Creating Internet (URL) Shortcuts</a></h4>
 268 <blockquote>
 269 <p>First create a file named, for example, "website.url", and place these lines inside it:</p>
 270 <p><tt>[InternetShortcut]<br />
 271 URL=http://web.site.address/
 272 </tt></p>
 273 <p>Then add these lines to your script:</p>
 274 <p><tt><b>[Files]</b><br />
 275 <font color="blue">Source</font>: "website.url"; <font color="blue">DestDir</font>: "{app}"<br />
 276 <br />
 277 <b>[Icons]</b><br />
 278 <font color="blue">Name</font>: "{group}\Visit My Web Site"; <font color="blue">Filename</font>: "{app}\website.url"<br />
 279 </tt></p>
 280 </blockquote>
 281
 282
 283 <h4><a name="startin">Setting the "Start In" Field on a Shortcut</a></h4>
 284 <blockquote>
 285 <p>Use a WorkingDir parameter on the [Icons] section entry.</p>
 286 </blockquote>
 287
 288 <h4><a name="assoc">Creating File Associations</a></h4>
 289 <blockquote>
 290 <p>First set the [Setup] section directive "ChangesAssociations" to "yes". Then create [Registry] entries as shown below. </p>
 291
 292 <p><tt>
 293 <b>[Registry]</b><br />
 294 <font color="blue">Root</font>: HKCR; <font color="blue">Subkey</font>: ".myp"; <font color="blue">ValueType</font>: string; <font color="blue">ValueName</font>: ""; ValueData: "MyProgramFile"; <font color="blue">Flags</font>: uninsdeletevalue
 295 </tt></p>
 296 <blockquote>
 297 ".myp" is the extension we're associating. "MyProgramFile" is the internal name for the file type as stored in the registry. Make sure you use a unique name for this so you don't inadvertently overwrite another application's registry key.
 298 </blockquote>
 299
 300 <p><tt>
 301 <font color="blue">Root</font>: HKCR; <font color="blue">Subkey</font>: "MyProgramFile"; <font color="blue">ValueType</font>: string; <font color="blue">ValueName</font>: ""; <font color="blue">ValueData</font>: "My Program File"; <font color="blue">Flags</font>: uninsdeletekey
 302 </tt></p>
 303 <blockquote>
 304 "My Program File" above is the name for the file type as shown in Explorer.
 305 </blockquote>
 306
 307 <p><tt>
 308 <font color="blue">Root</font>: HKCR; <font color="blue">Subkey</font>: "MyProgramFile\DefaultIcon"; <font color="blue">ValueType</font>: string; <font color="blue">ValueName</font>: ""; <font color="blue">ValueData</font>: "{app}\MYPROG.EXE,0"
 309 </tt></p>
 310 <blockquote>
 311 "DefaultIcon" is the registry key that specifies the filename containing the icon to associate with the file type. ",0" tells Explorer to use the first icon from MYPROG.EXE. (",1" would mean the second icon.)
 312 </blockquote>
 313
 314 <p><tt>
 315 <font color="blue">Root</font>: HKCR; <font color="blue">Subkey</font>: "MyProgramFile\shell\open\command"; <font color="blue">ValueType</font>: string; <font color="blue">ValueName</font>: ""; <font color="blue">ValueData</font>: """{app}\MYPROG.EXE"" ""%1"""
 316 </tt></p>
 317 <blockquote>
 318 "shell\open\command" is the registry key that specifies the program to execute when a file of the type is double-clicked in Explorer. The surrounding quotes are in the command line so it handles long filenames correctly.
 319 </blockquote>
 320 </blockquote>
 321
 322 <h4><a name="env">Setting Environment Variables</a></h4>
 323 <blockquote>
 324 <p>Environment variables are stored as string values in the registry, so it is possible to manipulate them using the [Registry] section. System-wide environment variables are located at:</p>
 325 <blockquote>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment</blockquote>
 326 <p>User-specific environment variables are located at:</p>
 327 <blockquote>HKEY_CURRENT_USER\Environment</blockquote>
 328 </blockquote>
 329
 330 <h4><a name="closeonexit">Setting the "Close on Exit" Box on a Shortcut to an MS-DOS Program</a></h4>
 331 <blockquote>
 332 <p>Inno Setup version 1.3.15 and later includes support for "closeonexit" and "dontcloseonexit" flags in the [Icons] section.</p>
 333 </blockquote>
 334
 335 <h4><a name="backup">Making Backups Before Replacing Files</a></h4>
 336 <blockquote>
 337 <p>Inno Setup does not currently have a specific feature for doing that, but you can make a copy of a file before it is replaced by using a [Files] section entry similar to this:</p>
 338 <p><tt><font color="blue">Source</font>: "{app}\MyProg.exe"; <font color="blue">DestDir</font>: "{app}\backup"; <font color="blue">Flags</font>: external skipifsourcedoesntexist uninsneveruninstall</tt></p>
 339 </blockquote>
 340
 341 <h4><a name="difffiles">Installing Different Files Depending on Windows Version</a></h4>
 342 <blockquote>
 343 <p>That can be done via MinVersion and/or OnlyBelowVersion parameters on an entry. See the Common Parameters topic in the documentation for details.</p>
 344 </blockquote>
 345
 346 <h4><a name="perms">Settings Permissions on Files, Directories, or Registry Keys</a></h4>
 347 <blockquote>
 348 <p>Beginning with Inno Setup 4.1.0, the [Dirs], [Files], and [Registry] sections support Permissions parameters for setting permissions on directories, files, and registry keys respectively.</p>
 349 <p>If you have more advanced needs, take a look at <a href="http://setacl.sourceforge.net/">SetACL</a>.</p>
 350 </blockquote>
 351
 352 <h4><a name="custom">My installation needs to do something that Inno Setup apparently doesn't have a feature for.</a></h4>
 353 <blockquote>
 354 <p>See the Knowledge Base article <a href="http://www.jrsoftware.org/iskb.php?custom">Implementing Custom Functionality</a>.</p>
 355 </blockquote>
 356
 357
 358
 359 <hr /><h2>How Do I Install...?</h2>
 360
 361 <h4><a name="ocx">OCX Files</a></h4>
 362 <blockquote>
 363 <p>The recommended way to install an OCX file is as follows.</p>
 364 <p><tt>
 365 <b>[Files]</b><br />
 366 <font color="blue">Source</font>: "ComCtl32.ocx";
 367         <font color="blue">DestDir</font>: "{sys}";
 368         <font color="blue">CopyMode</font>: alwaysskipifsameorolder;
 369         <font color="blue">Flags</font>: restartreplace sharedfile regserver
 370 </tt></p>
 371 </blockquote>
 372
 373 <h4><a name="vb">Visual Basic System Files</a></h4>
 374 <blockquote>
 375 <p>See <a href="http://www.jrsoftware.org/iskb.php?vb">this Knowledge Base article</a>.</p>
 376 </blockquote>
 377
 378 <h4><a name="vc">Visual C++ System Files (e.g. MFC)</a></h4>
 379 <blockquote>
 380 <p>See <a href="http://www.jrsoftware.org/iskb.php?vc">this Knowledge Base article</a>.</p>
 381 </blockquote>
 382
 383 <h4><a name="comctl32">COMCTL32.DLL</a></h4>
 384 <blockquote>
 385 <p>If your application requires an updated version of COMCTL32.DLL, you can direct your users to
 386 <a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=cb2cf3a2-8025-4e8f-8511-9b476a8d35d2&amp;DisplayLang=en">download</a>
 387 the COMCTL32 update from Microsoft, or call the COMCTL32 update from your installation by using the following lines:</p>
 388 <p><tt>
 389 <b>[Files]</b><br />
 390 <font color="blue">Source</font>: "50comupd.exe"; <font color="blue">DestDir</font>: "{tmp}"<br />
 391 <br />
 392 <b>[Code]</b><br />
 393 function ShouldInstallComCtlUpdate: Boolean;<br />
 394 var<br />
 395 &nbsp;&nbsp;MS, LS: Cardinal;<br />
 396 begin<br />
 397 &nbsp;&nbsp;// Only install if the existing comctl32.dll is &lt; 5.80<br />
 398 &nbsp;&nbsp;Result := False;<br />
 399 &nbsp;&nbsp;if GetVersionNumbers(ExpandConstant('{sys}\comctl32.dll'), MS, LS) then<br />
 400 &nbsp;&nbsp;&nbsp;&nbsp;if MS &lt; $00050050 then<br />
 401 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Result := True;<br />
 402 end;<br />
 403 <br />
 404 <b>[Run]</b><br />
 405 <font color="blue">Filename</font>: "{tmp}\50comupd.exe"; <font color="blue">Parameters</font>: "/r:n /q:1"; <font color="blue">Check</font>: ShouldInstallComCtlUpdate
 406 </tt></p>
 407 <p>Don't try to install COMCTL32.DLL directly using the [Files] section; Microsoft <a href="http://www.microsoft.com/permission/copyrgt/cop-soft.htm#COM">does not allow</a> this, and it's dangerous.</p>
 408 </blockquote>
 409
 410 <h4><a name="bde">BDE (Borland Database Engine)</a></h4>
 411 <blockquote>
 412 <p>See the Knowledge Base article <a href="http://www.jrsoftware.org/iskb.php?bde">Installing BDE</a> for details on deploying the 32-bit version of BDE using Inno Setup.</p>
 413 </blockquote>
 414
 415 <h4><a name="mdac">MDAC, ADO, Jet, etc.</a></h4>
 416 <blockquote>
 417 <p>See <a href="http://www.jrsoftware.org/iskb.php?dcommdac">this Knowledge Base article</a>.</p>
 418 </blockquote>
 419
 420
 421
 422 <hr /><h2>Compatibility</h2>
 423
 424 <h4><a name="oscompat">OS Compatibility</a></h4>
 425 <blockquote>
 426 <p>Currently supported platforms include every Windows release since 2000. No service packs or other OS updates are required on any of the supported platforms.</p>
 427 <p>The 16-bit version of Inno Setup was discontinued starting with version 1.3. Support for Windows NT 3.51 was discontinued starting with version 3.0. Support for Windows 95, 98, Me, and NT 4.0 was discontinued starting with version 5.5.</p>
 428 </blockquote>
 429
 430 <h4><a name="ntsecur">Administrative Privileges</a></h4>
 431 <blockquote>
 432 <p>A typical Inno Setup installation does not require administrative or "power user" privileges. However, there are exceptions as noted below.</p>
 433 <p>Things that require administrative privileges:</p>
 434 <ul>
 435 <li>Using "PrivilegesRequired=admin" in the script's [Setup] section. This causes Setup to abort with an error message if the user lacks administrative privileges.</li>
 436 <li>Using the "restartreplace" flag in the [Files] section. This flag causes Inno Setup to call the MoveFileEx function, which attempts to write to "HKEY_LOCAL_MACHINE\ SYSTEM\ CurrentControlSet\ Control\ Session Manager". Write access to this key is restricted to Administrators.</li>
 437 <li>Writing to any key under HKEY_USERS\.DEFAULT using the [Registry] section. Write access to this key is restricted to Administrators.</li>
 438 </ul>
 439 <p>Things that require <i>either</i> administrative or "power user" privileges:</p>
 440 <ul>
 441 <li>Using "PrivilegesRequired=poweruser" in the script's [Setup] section. This causes Setup to abort with an error message if the user lacks either administrative or "power user" privileges.</li>
 442 <li>Using the "regserver" flag in the [Files] section. In most cases registering a DLL involves writing to HKEY_CLASSES_ROOT, a privilege not granted to ordinary users.</li>
 443 <li>Using the "sharedfile" flag is the [Files] section. This flag causes Inno Setup to create/update a value in "HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\ Windows\ CurrentVersion\ SharedDLLs". Ordinary users are not allowed to write to that key.</li>
 444 <li>Using the FontInstall parameter in the [Files] section.</li>
 445 <li>Writing to any key under HKEY_LOCAL_MACHINE or HKEY_CLASSES_ROOT using the [Registry] section. Ordinary users are not allowed to write to those keys.</li>
 446 </ul>
 447 <p>Inno Setup itself does not require write access to the WINNT directory, or any other registry keys not mentioned above.</p>
 448 <p>What is different when an installation is run by a user <i>without</i> administrative privileges?</p>
 449 <ul>
 450 <li>The registry key for the <i>Add/Remove Programs</i> Control Panel entry is created under HKEY_CURRENT_USER instead of HKEY_LOCAL_MACHINE. Thus, only the user who installed the program will see an <i>Add/Remove Programs</i> entry for it.</li>
 451 <li>The "{group}" constant always points to the current user's profile, as opposed to the All Users profile.</li>
 452 <li>All "{common...}" constants are equivalent to the "{user...}" constants.</li>
 453 <li>The program may be uninstalled by any user. (When an administrator installs a program, only an administrator is allowed to uninstall it.)</li>
 454 </ul>
 455 </blockquote>
 456
 457
 458
 459 <hr /><h2>Miscellaneous</h2>
 460
 461 <h4><a name="limits">Are there any limits on how many files, etc. may be included in an installation?</a></h4>
 462 <blockquote>
 463 <p>Inno Setup places no arbitrary limits on how many files, shortcuts, registry entries, etc. that you may include in an installation. However, keep in mind that Setup does need memory for each entry in a script. For example, roughly 120 bytes of memory is needed for each [Files] entry.</p>
 464 <p>In Inno Setup 3.x and earlier, installations and individual files cannot exceed 2 GB, because it does not use 64-bit arithmetic in most places. This has been addressed in Inno Setup 4.</p>
 465 </blockquote>
 466
 467 <h4><a name="cancel">What exactly happens when the user clicks Cancel during an installation?</a></h4>
 468 <blockquote>
 469 <p>When Cancel is clicked, Setup will begin reverting changes it's made so far in the very same manner as the Uninstall program. Thus, a partially installed application isn't left over.</p>
 470 </blockquote>
 471
 472
 473 </body>
 474 </html>