1page
Ppp INSTALLSHIELD® INSTALLSCRIPT™ LANGUAGE REFERENCE GUIDE Version 12
2page
Copyright Notice Copyright © 1996–2006 Macrovision Corporation and/or Macrovision Europe Ltd. All Rights Reserved. This product contains proprietary and confidential technology provided by and owned by Macrovision Europe Ltd., UK, and Mac rovision Corporation of Santa Clara, California, U.S.A. Any use, copying, publication, distribution, display, modification, or transmission of such techno logy in whole or in part in any form or by any means without the prior express written permission of Macrovision Europe Ltd. and Macrovision Corporatio n is strictly prohibited. Except where expressly provided by Macrovision Europe Ltd. and Macrovision Corporation in writing, possession of this technol ogy shall not be construed to confer any license or rights under any of Macrovision Europe Ltd. and Macrovision Corporation’s intellectual property rights, whether by estoppel, implication, or otherwise. ALL COPIES OF THE TECHNOLOGY and RELATED INFORMATION, IF ALLOWED BY MACROVISION CORPORATION, MUST DISPLA Y THIS NOTICE OF COPYRIGHT AND OWNERSHIP IN FULL. Trademarks Macrovision, DemoShield, FLEXnet, FLEXnet Manager, FLEXnet Publisher, InstallShield, InstallShield Developer, InstallShield Dev Studio, InstallShield Professional, OneClickInstall, and QuickPatch are registered trademarks or trademarks of Macrovision Corporation in the United States of America and/or other countries. All other brand and product names mentioned herein are the trademarks and registered trademarks of their re spective owners. Restricted Rights Legend The software and documentation are “commercial items,” as that term is defined at 48 C.F.R. §2.101, consisting of “commerci al computer software” and “commercial computer software documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.2702, as ap plicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §227.2702-1 through 227.7202-4, as applicable, the commercial computer software and comm ercial computer software documentation are being licensed to U.S. government end users (A) only as commercial items and (B) with only those rights as a re granted to all other end users pursuant to the terms and conditions set forth in the Macrovision Corporation standard commercial agreement for this so ftware. Unpublished rights reserved under the copyright laws of the United States of America. February 2005
3page
CONTENTS InstallShield InstallScript Language Reference Guide iii 1 InstallScript Language Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Integrated Compiler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Command-Line Compiler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2 Setup Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Structure of a Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Declarations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Program Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Function Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Identifiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Syntax Punctuation Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Writing Comments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Using White Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Hungarian Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Escape Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Embedding Quotation Marks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Format Specifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Reserved Words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 3 L ang ua g e K e y wo rd s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 abort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 BOOL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4page
Table of Contents iv InstallShield InstallScript Language Reference Guide cdecl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 external . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 for...endfor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 goto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 if Structure with goto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 if-then Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 if-then-else Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Nested if-then-else Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 elseif Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 property(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 repeat...until. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 return. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 stdcall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 switch...endswitch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 try, catch, and endcatch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 void. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 while...endwhile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Nested while Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 Flow Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 4 Predefined Constants. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 AFTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 ALLCONTENTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 ALLCONTROLS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 APPEND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 ASKDESTPATH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 ASKOPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 ASKPATH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 ASKTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
5page
Table of Contents InstallShield InstallScript Language Reference Guide v BACK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 BACKBUTTON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 BACKGROUND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 BACKGROUNDCAPTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 BASEMEMORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 BEFORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 BIF _ BROWSEFORCOMPUTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 BIF _ BROWSEFORPRINTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 BIF _ DONTGOBELOWDOMAIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 BIF _ EDITBOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 BIF _ RETURNFSANCESTORS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 BIF _ RETURNONLYFSDIRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 BIF _ STATUSTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 BILLBOARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 BITMAPICON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 BK _ BLUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 BK _ GREEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 BK _ MAGENTA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 BK _ ORANGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 BK _ PINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 BK _ RED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 BK _ SMOOTH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 BK _ SOLIDBLACK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 BK _ SOLIDBLUE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 BK _ SOLIDGREEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 BK _ SOLIDMAGENTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 BK _ SOLIDORANGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 BK _ SOLIDPINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 BK _ SOLIDRED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 BK _ SOLIDWHITE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 BK _ SOLIDYELLOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 BK _ YELLOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6page
Table of Contents vi InstallShield InstallScript Language Reference Guide BLACK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 BLUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 BOOTUPDRIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 BUTTON _ CHECKED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 BUTTON _ UNCHECKED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 BYTES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 CANCEL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 CANCELBUTTON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 CDROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 CDROM _ DRIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 CENTERED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 CHECKBOX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 CHECKBOX95. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 CHECKLINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 CHECKMARK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 COLORS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 COMMAND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 COMMON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 COMPACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 COMPARE _ DATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 COMPARE _ MD5 _ SIGNATURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 COMPARE _ SIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 COMPARE _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 COMP _ NORMAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 COMP _ UPDATE _ DATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 COMP _ UPDATE _ SAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 COMP _ UPDATE _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 CONTINUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 COPY _ ERR _ CREATEDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 COPY _ ERR _ MEMORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 COPY _ ERR _ NODISKSPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 COPY _ ERR _ OPENINPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
7page
Table of Contents InstallShield InstallScript Language Reference Guide vii COPY _ ERR _ OPENOUTPUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 COPY _ ERR _ TARGETREADONLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 CPU. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 CURRENTROOTKEY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 CUSTOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 DATA _ COMPONENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 DATA _ LIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 DATA _ NUMBER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 DATA _ STRING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 DATE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 DEFAULT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 DEFWINDOWMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 DELETE _ EOF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 DIALOGCACHE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 DIFXAPI _ ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 DIFXAPI _ INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 DIFXAPI _ SUCCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 DIFXAPI _ WARNING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 DIRECTORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 DIR _ WRITEABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 DISABLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 DISABLE _ ALLUSERBTN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 DISABLE _ PERUSERBTN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 DISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 DISK1FEATURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 DISK _ INFO _QUERY_ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 DISK _ INFO _QUERY_BYTES_PER_CLUSTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 DISK _ INFO _QUERY_DISK_FREE_SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 DISK _ INFO _QUERY_DISK_TOTAL_SPACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 DISK _ INFO _QUERY_DRIVE_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 DISK _ TOTALSPACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
8page
Table of Contents viii InstallShield InstallScript Language Reference Guide DISK _ TOTALSPACE _ EX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 DLG _ ASK _ OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 DLG _ ASK _ PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 DLG _ ASK _ TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 DLG _ ASK _ YESNO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 DLG _ CENTERED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 DLG _ CLOSE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 DLG _ DIR _ DIRECTORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 DLG _ DIR _ DRIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 DLG _ DIR _ FILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 DLG _ ENTER _ DISK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 DLG _ ERR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 DLG _ ERR _ ALREADY _ EXISTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 DLG _ ERR _ ENDDLG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 DLG _ INFO _ ALTIMAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 DLG _ INFO _ CHECKSELECTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 DLG _ INFO _ KUNITS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 DLG _ INFO _ USEDECIMAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 DLG _ INIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 DLG _ MSG _ ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 DLG _ MSG _ INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 DLG _ MSG _ SEVERE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 DLG _ MSG _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 DLG _ MSG _ WARNING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 DLG _ STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 DLG _ USER _ CAPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 DOINSTALL _ OPTION _ NOHIDEPROGRESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 DOINSTALL _ OPTION _ NOHIDESPLASH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 DOINSTALL _ OPTION _ NOLANGSWITCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 DOINSTALL _ OPTION _ NOSETBATCHINSTALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 DOTNETFRAMEWORKINSTALLED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 DRIVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
9page
Table of Contents InstallShield InstallScript Language Reference Guide ix DRIVE _ CDROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 DRIVE _ FIXED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 DRIVE _ NO _ ROOT _ DIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 DRIVE _ RAMDISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 DRIVE _ REMOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 DRIVE _ REMOVABLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 DRIVE _ UNKNOWN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 DRIVER _ PACKAGE _ DELETE _ FILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 DRIVER _ PACKAGE _ FORCE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 DRIVER _ PACKAGE _ LEGACY _ MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 DRIVER _ PACKAGE _ ONLY _ IF _ DEVICE _ PRESENT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 DRIVER _ PACKAGE _ REPAIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 DRIVER _ PACKAGE _ SILENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 EDITBOX _ CHANGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 EFF _ BOXSTRIPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 EFF _ FADE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 EFF _ HORZREVEAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 EFF _ HORZSTRIPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 EFF _ NONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 EFF _ REVEAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 EFF _ VERTSTRIPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 ENABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 END _ OF _ FILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 END _ OF _ LIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 ENTERDISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 EQUALS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 ERROR _ ACCESS _ DENIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 ERROR _ CIRCULAR _ DEPENDENCY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 ERROR _ DATABASE _ DOES _ NOT _ EXIST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 ERROR _ DEPENDENT _ SERVICES _ RUNNING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 ERROR _ DUP _ NAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 ERROR _ FILE _ NOT _ FOUND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
10page
Table of Contents x InstallShield InstallScript Language Reference Guide ERROR _ INVALID _ HANDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 ERROR _ INVALID _ PARAMETER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 ERROR _ INVALID _ SERVICE _ ACCOUNT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 ERROR _ INVALID _ SERVICE _ CONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 ERROR _ PATH _ NOT _ FOUND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 ERROR _ SERVICE _ ALREADY _ RUNNING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 ERROR _ SERVICE _ CANNOT _ ACCEPT _ CTRL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 ERROR _ SERVICE _ DATABASE _ LOCKED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 ERROR _ SERVICE _ DEPENDENCY _ DELETED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 ERROR _ SERVICE _ DEPENDENCY _ FAIL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 ERROR _ SERVICE _ DISABLED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 ERROR _ SERVICE _ DOES _ NOT _ EXIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 ERROR _ SERVICE _ EXISTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 ERROR _ SERVICE _ LOGON _ FAILED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 ERROR _ SERVICE _ NOT _ ACTIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 ERROR _ SERVICE _ NO _ THREAD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 ERROR _ SERVICE _ REQUEST_TIMEOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 ERROR _ TIMEOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 ERR _ ABORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 ERR _ BOX _ BADPATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 ERR _ BOX _ BADTAGFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 ERR _ BOX _ DISKID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 ERR _ BOX _ DRIVEOPEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 ERR _ IGNORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 ERR _ NO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 ERR _ PERFORM _ AFTER _ REBOOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 ERR _ RETRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 ERR _ YES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 EXCLUDE _ SUBDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 EXCLUSIVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 EXISTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 EXIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
11page
Table of Contents InstallShield InstallScript Language Reference Guide xi EXTENDEDMEMORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 EXTENSION _ ONLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 FALSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 FEATURE _ FIELD _ CDROM _ FOLDER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 FEATURE _ FIELD _ DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 FEATURE _ FIELD _ DISPLAYNAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 FEATURE _ FIELD _ FILENEED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 FEATURE _ FIELD _ FTPLOCATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 FEATURE _ FIELD _ HTTPLOCATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 FEATURE _ FIELD _ IMAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 FEATURE _ FIELD _ MISC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 FEATURE _ FIELD _ PASSWORD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 FEATURE _ FIELD _ SELECTED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 FEATURE _ FIELD _ SIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 FEATURE _ FIELD _ STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 FEATURE _ FIELD _ VISIBLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 FEATURE _ INFO _ ATTRIBUTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 FEATURE _ INFO _ COMPSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 FEATURE _ INFO _ COMPSIZE _ HIGH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 FEATURE _ INFO _ COMPSIZE _ LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 FEATURE _ INFO _ DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 FEATURE _ INFO _ DATE _ EX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 FEATURE _ INFO _ LANGUAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 FEATURE _ INFO _ MD5 _ SIGNATURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 FEATURE _ INFO _ ORIGSIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 FEATURE _ INFO _ ORIGSIZE _ HIGH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 FEATURE _ INFO _ ORIGSIZE _ LOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 FEATURE _ INFO _ OS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 FEATURE _ INFO _ PLATFORM _ SUITE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 FEATURE _ INFO _ TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 FEATURE _ INFO _ VERSIONLS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 FEATURE _ INFO _ VERSIONMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
12page
Table of Contents xii InstallShield InstallScript Language Reference Guide FEATURE _ INFO _ VERSIONSTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 FEATURE _ OPCOST _ UNINSTALL _ FILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 FEATURE _ OPCOST _ UNINSTALL _ REGORINI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 FEATURE _ OPCOST _ UNINSTALL _ UNREGFILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 FEATURE _ VALUE _ CRITICAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 FEATURE _ VALUE _ HIGHLYRECOMMENDED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 FEATURE _ VALUE _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 File Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 FILENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 FILENAME _ ONLY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 FILE _ ATTRIBUTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 FILE _ ATTR _ ARCHIVED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 FILE _ ATTR _ HIDDEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 FILE _ ATTR _ NORMAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 FILE _ ATTR _ READONLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 FILE _ ATTR _ SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 FILE _ BIN _ CUR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 FILE _ BIN _ END . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 FILE _ BIN _ START. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 FILE _ DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 FILE _ EXISTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 FILE _ INSTALLED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 FILE _ IS _ LOCKED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 FILE _ LINE _ LENGTH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 FILE _ LOCKED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 FILE _ MD5 _ SIGNATURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 FILE _ MODE _ APPEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 FILE _ MODE _ APPEND _ UNICODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 FILE _ MODE _ BINARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 FILE _ MODE _ BINARYREADONLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 FILE _ MODE _ NORMAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 FILE _ NOT _ FOUND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
13page
Table of Contents InstallShield InstallScript Language Reference Guide xiii FILE _ NO _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 FILE _ RD _ ONLY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 FILE _ SHARED _ COUNT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 FILE _ SIZE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 FILE _ SIZE _ HIGH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 FILE _ SIZE _ LOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 FILE _ SRC _ OLD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 FILE _ TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 FILE _ WRITEABLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 FIXED _ DRIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 FONT _ AVAILABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 FULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 FULLSCREEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 FULLSCREENSIZE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 FULLWINDOWMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 FUNCTION _ EXPORTED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 GBYTES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 GREATER _ THAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 GREEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 HKEY _ CLASSES _ ROOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 HKEY _ CURRENT _ USER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 HKEY _ LOCAL _ MACHINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 HKEY _ USERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 HKEY _ USER _ SELECTABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 HOURGLASS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 HWND _ DESKTOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 HWND _ INSTALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 IDCANCEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 IDOK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 IDS _ IFX _ ERROR _ INVALID _ MEDIA _ PASSWORD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 IFX _ ONNEXTDISK _ PACKAGE _ CAPTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
14page
Table of Contents xiv InstallShield InstallScript Language Reference Guide IFX _ ONNEXTDISK _ PACKAGE _ MSG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 INCLUDE _ SUBDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 INDVFILESTATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 INFORMATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 ISDIFX _ OPTION _ DONT _ ASSOCIATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 ISDIFX _ OPTION _ DONT _ RESOLVE _ TEXTSUBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 ISDIFX _ OPTION _ LOG _ IN _ DRIVER _ PACKAGE _ PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 ISDIFX _ OPTION _ NO _ REPAIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 ISERR _ GEN _ FAILURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 ISERR _ SUCCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 ISLANG _ AFRIKAANS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 ISLANG _ AFRIKAANS _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 ISLANG _ ALBANIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 ISLANG _ ALBANIAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 ISLANG _ ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 ISLANG _ ARABIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 ISLANG _ ARABIC _ ALGERIA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 ISLANG _ ARABIC _ BAHRAIN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 ISLANG _ ARABIC _ EGYPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 ISLANG _ ARABIC _ IRAQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 ISLANG _ ARABIC _ JORDAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 ISLANG _ ARABIC _ KUWAIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 ISLANG _ ARABIC _ LEBANON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 ISLANG _ ARABIC _ LIBYA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 ISLANG _ ARABIC _ MOROCCO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 ISLANG _ ARABIC _ OMAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 ISLANG _ ARABIC _QATAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 ISLANG _ ARABIC _ SAUDIARABIA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 ISLANG _ ARABIC _ SYRIA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 ISLANG _ ARABIC _ TUNISIA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 ISLANG _ ARABIC _ UAE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 ISLANG _ ARABIC _ YEMEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
15page
Table of Contents InstallShield InstallScript Language Reference Guide xv ISLANG _ BASQUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 ISLANG _ BASQUE_STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 ISLANG _ BELARUSIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 ISLANG _ BELARUSIAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 ISLANG _ BULGARIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 ISLANG _ BULGARIAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 ISLANG _ CATALAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 ISLANG _ CATALAN _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 ISLANG _ CHINESE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 ISLANG _ CHINESE _ HONGKONG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 ISLANG _ CHINESE _ PRC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 ISLANG _ CHINESE _ SINGAPORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 ISLANG _ CHINESE _ TAIWAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 ISLANG _ CROATIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 ISLANG _ CROATIAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 ISLANG _ CZECH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 ISLANG _ CZECH _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 ISLANG _ DANISH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 ISLANG _ DANISH _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 ISLANG _ DUTCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 ISLANG _ DUTCH _ BELGIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 ISLANG _ DUTCH _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 ISLANG _ ENGLISH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 ISLANG _ ENGLISH _ AUSTRALIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 ISLANG _ ENGLISH _ BELIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 ISLANG _ ENGLISH _ CANADIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 ISLANG _ ENGLISH _ CARIBBEAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 ISLANG _ ENGLISH _ IRELAND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 ISLANG _ ENGLISH _ JAMAICA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 ISLANG _ ENGLISH _ NEWZEALAND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 ISLANG _ ENGLISH _ SOUTHAFRICA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 ISLANG _ ENGLISH _ TRINIDAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
16page
Table of Contents xvi InstallShield InstallScript Language Reference Guide ISLANG _ ENGLISH _ UNITEDKINGDOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 ISLANG _ ENGLISH _ UNITEDSTATES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 ISLANG _ ESTONIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 ISLANG _ ESTONIAN _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 ISLANG _ FAEROESE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 ISLANG _ FAEROESE _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 ISLANG _ FARSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 ISLANG _ FARSI _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 ISLANG _ FINNISH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 ISLANG _ FINNISH _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 ISLANG _ FRENCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 ISLANG _ FRENCH _ BELGIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 ISLANG _ FRENCH _ CANADIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 ISLANG _ FRENCH _ LUXEMBOURG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 ISLANG _ FRENCH _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 ISLANG _ FRENCH _ SWISS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132 ISLANG _ GERMAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 ISLANG _ GERMAN _ AUSTRIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 ISLANG _ GERMAN _ LIECHTENSTEIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 ISLANG _ GERMAN _ LUXEMBOURG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 ISLANG _ GERMAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 ISLANG _ GERMAN _ SWISS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 ISLANG _ GREEK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 ISLANG _ GREEK _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 ISLANG _ HEBREW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 ISLANG _ HEBREW _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 ISLANG _ HUNGARIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 ISLANG _ HUNGARIAN _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 ISLANG _ ICELANDIC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 ISLANG _ ICELANDIC _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 ISLANG _ INDONESIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 ISLANG _ INDONESIAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
17page
Table of Contents InstallShield InstallScript Language Reference Guide xvii ISLANG _ ITALIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 ISLANG _ ITALIAN _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 ISLANG _ ITALIAN _ SWISS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 ISLANG _ JAPANESE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 ISLANG _ JAPANESE _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 ISLANG _ KOREAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 ISLANG _ KOREAN _ JOHAB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 ISLANG _ KOREAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 ISLANG _ LATVIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 ISLANG _ LATVIAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 ISLANG _ LITHUANIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 ISLANG _ LITHUANIAN _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 ISLANG _ NORWEGIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 ISLANG _ NORWEGIAN _ BOKMAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 ISLANG _ NORWEGIAN _ NYNORSK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 ISLANG _ POLISH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 ISLANG _ POLISH _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 ISLANG _ PORTUGUESE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 ISLANG _ PORTUGUESE _ BRAZILIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137 ISLANG _ PORTUGUESE _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 ISLANG _ ROMANIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 ISLANG _ ROMANIAN _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 ISLANG _ RUSSIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 ISLANG _ RUSSIAN _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 ISLANG _ SERBIAN _ CYRILLIC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 ISLANG _ SERBIAN _ LATIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 ISLANG _ SLOVAK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 ISLANG _ SLOVAK _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 ISLANG _ SLOVENIAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 ISLANG _ SLOVENIAN _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 ISLANG _ SPANISH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 ISLANG _ SPANISH _ ARGENTINA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
18page
Table of Contents xviii InstallShield InstallScript Language Reference Guide ISLANG _ SPANISH _ BOLIVIA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 ISLANG _ SPANISH _ CHILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 ISLANG _ SPANISH _ COLOMBIA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 ISLANG _ SPANISH _ COSTARICA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 ISLANG _ SPANISH _ DOMINICANREPUBLIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 ISLANG _ SPANISH _ ECUADOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 ISLANG _ SPANISH _ ELSALVADOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 ISLANG _ SPANISH _ GUATEMALA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 ISLANG _ SPANISH _ HONDURAS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 ISLANG _ SPANISH _ MEXICAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 ISLANG _ SPANISH _ MODERNSORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 ISLANG _ SPANISH _ NICARAGUA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 ISLANG _ SPANISH _ PANAMA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 ISLANG _ SPANISH _ PARAGUAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 ISLANG _ SPANISH _ PERU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141 ISLANG _ SPANISH _ PUERTORICO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 ISLANG _ SPANISH _ TRADITIONALSORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 ISLANG _ SPANISH _ URUGUAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 ISLANG _ SPANISH _ VENEZUELA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 ISLANG _ SWEDISH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 ISLANG _ SWEDISH _ FINLAND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 ISLANG _ SWEDISH _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 ISLANG _ THAI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 ISLANG _ THAI _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 ISLANG _ TURKISH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 ISLANG _ TURKISH _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 ISLANG _ UKRAINIAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 ISLANG _ UKRAINIAN _ STANDARD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 ISLANG _ VIETNAMESE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 ISLANG _ VIETNAMESE _ STANDARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 ISOSL _ ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 ISOSL _ NT40. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
19page
Table of Contents InstallShield InstallScript Language Reference Guide xix ISOSL _ NT40 _ ALPHA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 ISOSL _ SUPPORTED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 ISOSL _ WIN2000. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 ISOSL _ WIN2000 _ ALPHA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 ISOSL _ WIN95. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 ISOSL _ WIN98. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 ISOSL _ WINME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 ISOSL _ WINSERVER2003. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 ISOSL _ WINXP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 ISOS _ ST _ ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 ISOS _ ST _ BACKOFFICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 ISOS _ ST _ DATACENTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 ISOS _ ST _ ENTERPRISE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 ISOS _ ST _ PROC _ ARCH _ 32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 ISOS _ ST _ PROC _ ARCH _ AMD64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 ISOS _ ST _ PROC _ ARCH _ IA64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 ISOS _ ST _ SERVER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 ISOS _ ST _ SMALLBUSINESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 ISOS _ ST _ SMALLBUSINESS _ RESTRICTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 ISOS _ ST _ TERMINAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 ISOS _ ST _ WORKSTATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 ISOS _ ST _ XP _ HOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 ISOS _ ST _ XP _ PRO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 ISUS _ AGENT _ FEATURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 ISUS _ MAIN _ FEATURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 ISUS _ TEXTSUB _ HOST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 ISUS _ TEXTSUB _ INTERVAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 ISUS _ TEXTSUB _ LANGUAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 ISUS _ TEXTSUB _ LOGO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 ISUS _ TEXTSUB _ MANAGER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 ISUS _ TEXTSUB _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 ISUS _ UPDATEMANAGER _ FEATURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
20page
Table of Contents xx InstallShield InstallScript Language Reference Guide IS _ 386. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 IS _ 486. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 IS _ ALPHA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 IS _ CDROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 IS _ EGA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 IS _ FIXED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 IS _ FOLDER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 IS _ ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 IS _ PENTIUM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 IS _ REMOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 IS _ REMOVABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 IS _ SVGA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 IS _ UNKNOWN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 IS _ UVGA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 IS _ VGA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 IS _ WINDOWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 IS _ WINDOWS9X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 IS _ WINDOWSNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 IS _ XVGA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 KBYTES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 LAAW _ OPTION _ HIDDEN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 LAAW _ OPTION _ MAXIMIZED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 LAAW _ OPTION _ MINIMIZED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 LAAW _ OPTION _ NO _ CHANGEDIRECTORY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 LAAW _ OPTION _ NOWAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 LAAW _ OPTION _ SET _ BATCH _ INSTALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 LAAW _ OPTION _ SHOW _ HOURGLASS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 LAAW _ OPTION _ USE _ CALLBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 LAAW _ OPTION _ WAIT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 LANG _ SUPPORTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 LANGUAGE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 LESS _ THAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
21page
Table of Contents InstallShield InstallScript Language Reference Guide xxi LINE _ NUMBER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 LISTBOX _ ENTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 LISTBOX _ SELECT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 LISTFIRST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 LISTLAST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162 LISTNEXT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 LISTPREV. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 LIST _ NULL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 LOCKEDFILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 LOGGING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 LOWER _ LEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 LOWER _ RIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 LWFT _ OPTION _ WRITE _ AS _ ANSI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 LWFT _ OPTION _ WRITE _ AS _ UNICODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 MAGENTA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 MATH _ COPROCESSOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 MBYTES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 MEDIA _ FIELD _ ADDREMOVE _ NOMODIFY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 MEDIA _ FIELD _ ADDREMOVE _ NOREMOVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 MEDIA _ FIELD _ COMPANY _ NAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 MEDIA _ FIELD _ MEDIA _ FLAGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 MEDIA _ FIELD _ PREVIOUS _ VERSIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 MEDIA _ FIELD _ PRODUCT _ COMMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167 MEDIA _ FIELD _ PRODUCT _ EXE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 MEDIA _ FIELD _ PRODUCT _ ICON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 MEDIA _ FIELD _ PRODUCT _ NAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 MEDIA _ FIELD _ PRODUCT _ README . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 MEDIA _ FIELD _ PRODUCT _ SUPPORT _ CONTACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 MEDIA _ FIELD _ PRODUCT _ SUPPORT _ PHONE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 MEDIA _ FIELD _ PRODUCT _ SUPPORT _ URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 MEDIA _ FIELD _ PRODUCT _ UPDATE _ URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170 MEDIA _ FIELD _ PRODUCT _ URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
22page
Table of Contents xxii InstallShield InstallScript Language Reference Guide MEDIA _ FIELD _ PRODUCT _ VERSION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 MEDIA _ FIELD _ TARGETDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 MEDIA _ FLAG _ FORMAT _ DIFFERENTIAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 MEDIA _ FLAG _ FORMAT _ PATCH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 MEDIA _ FLAG _ UPDATEMODE _ SUPPORTED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 MEDIA _ PASSWORD _ KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172 METAFILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 MMEDIA _ AVI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 MMEDIA _ MIDI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 MMEDIA _ PLAYASYNCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 MMEDIA _ PLAYCONTINUOUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 MMEDIA _ PLAYSYNCH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 MMEDIA _ STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 MMEDIA _ WAVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 MODIFY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 NEXT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 NEXTBUTTON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 NO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 NONEXCLUSIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 NORMALMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 NORMAL _ PRIORITY _ CLASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 NOSET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 NOTEXISTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 NO _ SUBDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 NULL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 NUMBERLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 OFF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 OK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 ON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 ONLYDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 OTHER _ FAILURE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 OUT _ OF _ DISK _ SPACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
23page
Table of Contents InstallShield InstallScript Language Reference Guide xxiii PARALLEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 PARTIAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 PATH _ EXISTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 PCRESTORE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 PERSONAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 READ _ CONTROL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 REBOOTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 RECORDMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 RED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 REGDBREMOTEREGCONNECTED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 REGDB _ APPPATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 REGDB _ APPPATH _ DEFAULT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 REGDB _ BINARY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183 REGDB _ ERR _ CONNECTIONEXISTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 REGDB _ ERR _ CORRUPTEDREGISTRY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 REGDB _ ERR _ INITIALIZATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 REGDB _ ERR _ INVALIDHANDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184 REGDB _ ERR _ INVALIDNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 REGDB _ KEYPATH _ APPPATHS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 REGDB _ KEYPATH _ DOTNET _ 10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 REGDB _ KEYPATH _ DOTNET _ 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 REGDB _ KEYPATH _ DOTNET _ 20 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 REGDB _ KEYPATH _ RUN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 REGDB _ KEYPATH _ RUNONCE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 REGDB _ KEYPATH _ RUNONCEEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 REGDB _ KEYPATH _ SHAREDDLLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 REGDB _ KEYPATH _ UNINSTALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 REGDB _ KEYPATH _ WINCURRVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 REGDB _ KEYPATH _ WINCURRVER _ AUTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 REGDB _ KEYPATH _ WINNTCURRVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 REGDB _ KEYS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
24page
Table of Contents xxiv InstallShield InstallScript Language Reference Guide REGDB _ NAMES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 REGDB _ NUMBER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 REGDB _ STRING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188 REGDB _ STRING _ EXPAND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 REGDB _ STRING _ MULTI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 REGDB _ UNINSTALL _ COMMENTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189 REGDB _ UNINSTALL _ CONTACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 REGDB _ UNINSTALL _ DISPLAYICON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 REGDB _ UNINSTALL _ DISPLAY _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 REGDB _ UNINSTALL _ HELPLINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 REGDB _ UNINSTALL _ HELPTELEPHONE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 REGDB _ UNINSTALL _ INSTALLDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 REGDB _ UNINSTALL _ INSTALLLOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 REGDB _ UNINSTALL _ INSTALLSOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 REGDB _ UNINSTALL _ LANGUAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 REGDB _ UNINSTALL _ LOGFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 REGDB _ UNINSTALL _ MAINT _ OPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 REGDB _ UNINSTALL _ MAJOR _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 REGDB _ UNINSTALL _ MINOR _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 REGDB _ UNINSTALL _ MODIFYPATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193 REGDB _ UNINSTALL _ NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 REGDB _ UNINSTALL _ NOMODIFY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 REGDB _ UNINSTALL _ NOREMOVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 REGDB _ UNINSTALL _ NOREPAIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 REGDB _ UNINSTALL _ PRODUCTGUID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 REGDB _ UNINSTALL _ PRODUCTID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 REGDB _ UNINSTALL _ PUBLISHER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 REGDB _ UNINSTALL _ README . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 REGDB _ UNINSTALL _ REGCOMPANY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 REGDB _ UNINSTALL _ REGOWNER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 REGDB _ UNINSTALL _ STRING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 REGDB _ UNINSTALL _ SYSTEMCOMPONENT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
25page
Table of Contents InstallShield InstallScript Language Reference Guide xxv REGDB _ UNINSTALL _ URLINFOABOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 REGDB _ UNINSTALL _ URLUPDATEINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 REGDB _ UNINSTALL _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 REGDB _ VALUENAME _ APPPATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 REGDB _ VALUENAME _ APPPATHDEFAULT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 REGDB _ VALUENAME _ INSTALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 REGDB _ VALUENAME _ SP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 REGDB _ VALUENAME _ UNINSTALL _ COMMENTS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 REGDB _ VALUENAME _ UNINSTALL _ CONTACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 REGDB _ VALUENAME _ UNINSTALL _ DISPLAYICON. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 REGDB _ VALUENAME _ UNINSTALL _ DISPLAYNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 REGDB _ VALUENAME _ UNINSTALL _ DISPLAYVERSION. . . . . . . . . . . . . . . . . . . . . . . . . . . 199 REGDB _ VALUENAME _ UNINSTALL _ HELPLINK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 REGDB _ VALUENAME _ UNINSTALL _ HELPTELEPHONE. . . . . . . . . . . . . . . . . . . . . . . . . . . 200 REGDB _ VALUENAME _ UNINSTALL _ INSTALLDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 REGDB _ VALUENAME _ UNINSTALL _ INSTALLLOCATION. . . . . . . . . . . . . . . . . . . . . . . . . . 200 REGDB _ VALUENAME _ UNINSTALL _ INSTALLSOURCE . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 REGDB _ VALUENAME _ UNINSTALL _ LANGUAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 REGDB _ VALUENAME _ UNINSTALL _ LOGFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 REGDB _ VALUENAME _ UNINSTALL _ LOGMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 REGDB _ VALUENAME _ UNINSTALL _ MAJORVERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 REGDB _ VALUENAME _ UNINSTALL _ MINORVERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 REGDB _ VALUENAME _ UNINSTALL _ MODIFYPATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 REGDB _ VALUENAME _ UNINSTALL _ NOMODIFY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 REGDB _ VALUENAME _ UNINSTALL _ NOREMOVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 REGDB _ VALUENAME _ UNINSTALL _ NOREPAIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 REGDB _ VALUENAME _ UNINSTALL _ PRODUCTGUID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 REGDB _ VALUENAME _ UNINSTALL _ PRODUCTID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 REGDB _ VALUENAME _ UNINSTALL _ PUBLISHER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 REGDB _ VALUENAME _ UNINSTALL _ README . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 REGDB _ VALUENAME _ UNINSTALL _ REGCOMPANY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 REGDB _ VALUENAME _ UNINSTALL _ REGOWNER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
26page
Table of Contents xxvi InstallShield InstallScript Language Reference Guide REGDB _ VALUENAME _ UNINSTALL _ SYSTEMCOMPONENT. . . . . . . . . . . . . . . . . . . . . . . . 203 REGDB _ VALUENAME _ UNINSTALL _ UNINSTALLSTRING. . . . . . . . . . . . . . . . . . . . . . . . . . 203 REGDB _ VALUENAME _ UNINSTALL _ URLINFOABOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 REGDB _ VALUENAME _ UNINSTALL _ URLUPDATEINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 REGDB _ VALUENAME _ UNINSTALL _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 REGDB _ VALUENAME _ WINCURRVER _ REGORGANIZATION . . . . . . . . . . . . . . . . . . . . . . . . 204 REGDB _ VALUENAME _ WINCURRVER _ REGOWNER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 REGDB _ WINCURRVER _ REGORGANIZATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 REGDB _ WINCURRVER _ REGOWNER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 REGFONT _ OPTION _ DEFAULT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 REGFONT _ OPTION _ DONTBROADCASTFONTCHANGEMSG . . . . . . . . . . . . . . . . . . . . . . . 205 REGFONT _ OPTION _ DONTUPDATEREGISTRY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 REGISTRYFUNCTIONS _ USETEXTSUBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 REMOTE _ DRIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 REMOVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 REMOVEABLE _ DRIVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 REMOVEALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 REPAIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 REPLACE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 RESTART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 ROOT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 RUN _ MAXIMIZED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 RUN _ MINIMIZED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 SELECTFOLDER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 SELFREGISTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 SELFREGISTERBATCH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 SELFREGISTRATIONPROCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 SERIAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 SERVICE _ ADAPTER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 SERVICE _ ALL _ ACCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 SERVICE _ AUTO _ START. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
27page
Table of Contents InstallShield InstallScript Language Reference Guide xxvii SERVICE _ BOOT _ START. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 SERVICE _ CHANGE _ CONFIG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 SERVICE _ CONTINUE _ PENDING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 SERVICE _ DEMAND _ START . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 SERVICE _ DISABLED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 SERVICE _ ENUMERATE _ DEPENDENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 SERVICE _ ERROR _ CRITICAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 SERVICE _ ERROR _ IGNORE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 SERVICE _ ERROR _ NORMAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 SERVICE _ ERROR _ SEVERE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 SERVICE _ FILE _ SYSTEM _ DRIVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 SERVICE _ FLAG _ DIFX _ 32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 SERVICE _ FLAG _ DIFX _ AMD64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 SERVICE _ FLAG _ DIFX _ IA64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 SERVICE _ FLAG _ ISFONTREG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 SERVICE _ INTERACTIVE _ PROCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 SERVICE _ INTERROGATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 SERVICE _ ISFONTREG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 SERVICE _ ISUPDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 SERVICE _ KERNEL _ DRIVER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 SERVICE _ PAUSED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 SERVICE _ PAUSE _ CONTINUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 SERVICE _ PAUSE _ PENDING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218 SERVICE _QUERY_CONFIG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 SERVICE _QUERY_STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 SERVICE _ RECOGNIZER _ DRIVER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 SERVICE _ RUNNING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 SERVICE _ START. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 SERVICE _ START _ PENDING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220 SERVICE _ STOP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 SERVICE _ STOPPED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 SERVICE _ STOP _ PENDING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
28page
Table of Contents xxviii InstallShield InstallScript Language Reference Guide SERVICE _ SYSTEM _ START. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 SERVICE _ USER _ DEFINED _ CONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 SERVICE _ WIN32 _ OWN _ PROCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 SERVICE _ WIN32 _ SHARE _ PROCESS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 SETUPTYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 SETUPTYPE _ INFO _ DESCRIPTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 SETUPTYPE _ INFO _ DISPLAYNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 SETUPTYPE _ STR _ COMPACT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 SETUPTYPE _ STR _ COMPLETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 SETUPTYPE _ STR _ CUSTOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 SETUPTYPE _ STR _ TYPICAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224 SETUP _ PACKAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 SEVERE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 SHAREDFILE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225 SILENTMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 SKIN _ LOADED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 SRCINSTALLDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 SRCTARGETDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 STANDARD _ RIGHTS _ REQUIRED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 STATUSBAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227 STATUSDLG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 STATUSEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 STATUSOLD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 STRINGLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 STYLE _ BOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 STYLE _ ITALIC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 STYLE _ NORMAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 STYLE _ SHADOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 STYLE _ UNDERLINE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 SW _ MAXIMIZE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 SW _ MINIMIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
29page
Table of Contents InstallShield InstallScript Language Reference Guide xxix SW _ RESTORE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230 SW _ SHOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 SYNCHRONIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 SYS _ BOOTMACHINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 TBYTES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231 TILED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 TIME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 TRUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232 TTFONTFILEINFO _ FONTTITLE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 TYPICAL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 UPDATESERVICECOMPONENT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233 UPPER _ LEFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 UPPER _ RIGHT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 USER _ ADMINISTRATOR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234 USER _ POWERUSER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 USE _ LOADED _ SKIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 VALID _ PATH. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 VERSION _ COMPARE _ RESULT _ NEWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 VERSION _ COMPARE _ RESULT _ NEWER _ NOT _ SUPPORTED . . . . . . . . . . . . . . . . . . . . . . . 236 VERSION _ COMPARE _ RESULT _ NOT _ INSTALLED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 VERSION _ COMPARE _ RESULT _ OLDER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 VERSION _ COMPARE _ RESULT _ SAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 VERSION _ PREVIOUS _ VERSION _ DELIMITER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 VER _ DLL _ NOT _ FOUND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 VER _ UPDATE _ ALWAYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 VER _ UPDATE _ COND. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 VIDEO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 VOLUMELABEL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 WARNING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 WEB _ BASED _ SETUP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 WELCOME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
30page
Table of Contents xxx InstallShield InstallScript Language Reference Guide WHITE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 WILL _ REBOOT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 WINDOWS _ SHARED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 WINMAJOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 WINMINOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240 WOW64FSREDIRECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 WRITE _ DAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 WRITE _ OWNER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 YELLOW. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 YES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 _ MAX _ PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 5 Predefined Script Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 __ FILE __ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 __ LINE __ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 BASICMSI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 INSTALLSCRIPTMSI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244 ISUS _ PRODUCT _ CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 SERVICE _ IS _ PARAMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245 SERVICE _ IS _ STATUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 6 Data Types and Predefined Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 Arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 Constant Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 Data Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 Language IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263 Pointers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 System Folder Properties (Destination Folders) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265 7 Variable Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 Global vs. Local Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270 String Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 String Indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272 String Size and Autosize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 System Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
31page
Table of Contents InstallShield InstallScript Language Reference Guide xxxi ADDREMOVE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 ADDREMOVE _ COMBINEDBUTTON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 ADDREMOVE _ HIDECHANGEOPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 ADDREMOVE _ HIDEREMOVEOPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 ADDREMOVE _ STRING _ REMOVEONLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 ADDREMOVE _ SYSTEMCOMPONENT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 ALLUSERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 How an InstallScript Installation Works by Default Depending on ALLUSERS . . . . . . . 281 BATCH _ INSTALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 CMDLINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 COMMONFILES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 COMMONFILES64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283 DISK1SETUPEXENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 DISK1TARGET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 ENABLED _ ISERVICES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 ENGINECOMMONDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284 ENGINEDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 ERRORFILENAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 FOLDER _ APPDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285 FOLDER _ APPLICATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 FOLDER _ APPLICATIONS64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 FOLDER _ COMMON _ APPDATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 FOLDER _ DESKTOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 FOLDER _ DOTNET _ 10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 FOLDER _ DOTNET _ 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 FOLDER _ DOTNET _ 20 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 FOLDER _ FONTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 FOLDER _ LOCAL _ APPDATA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288 FOLDER _ PERSONAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 FOLDER _ PROGRAMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 FOLDER _ STARTMENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 FOLDER _ STARTUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 FOLDER _ TEMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 HKEYCURRENTROOTKEY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 HKEY _ USER _ SELECTABLE _ AUTO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 IFX _ COMPANY _ NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 IFX _ DISK1INSTALLED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 IFX _ INITIALIZED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
32page
Table of Contents xxxii InstallShield InstallScript Language Reference Guide IFX _ INSTALLED _ DISPLAY _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 IFX _ INSTALLED _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 IFX _ KEYPATH _ PRODUCT _ INFO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293 IFX _ MULTI _ INSTANCE _ SUFFIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 IFX _ ONNEXTDISK _ PACKAGE _ CAPTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 IFX _ ONNEXTDISK _ PACKAGE _ MSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294 IFX _ PRODUCT _ COMMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 IFX _ PRODUCT _ DISPLAY _ NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 IFX _ PRODUCT _ DISPLAY _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 IFX _ PRODUCT _ ICON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295 IFX _ PRODUCT _ KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 IFX _ PRODUCT _ NAME. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 IFX _ PRODUCT _ README. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296 IFX _ PRODUCT _ REGISTEREDCOMPANY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 IFX _ PRODUCT _ REGISTEREDOWNER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 IFX _ PRODUCT _ REGISTEREDSERIALNUM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 IFX _ PRODUCT _ SUPPORT _ CONTACT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 IFX _ PRODUCT _ SUPPORT _ PHONE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 IFX _ PRODUCT _ SUPPORT _ URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298 IFX _ PRODUCT _ UPDATE _ URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 IFX _ PRODUCT _ URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 IFX _ PRODUCT _ VERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 IFX _ SETUP _ TITLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299 IFX _ SUPPORTED _ VERSIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 INFOFILENAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 INSTALLDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 INSTANCE _ GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300 INSTANCE _ GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 ISDIFXAPPID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 ISMSI _ HANDLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 ISRES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 ISUSER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 ISVERSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 LAAW _ PARAMETERS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 LAAW _ PROCESS _ INFORMATION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 LAAW _ STARTUPINFO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 MAINTENANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308 MAINT _ OPTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
33page
Table of Contents InstallShield InstallScript Language Reference Guide xxxiii MEDIA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 MODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 MSI _ TARGETDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309 MULTI _ INSTANCE _ COUNT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 PACKAGE _ LOCATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 PRODUCT _ GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 PRODUCT _ INSTALLED. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 PROGRAMFILES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310 PROGRAMFILES64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311 REGDB _ OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 REINSTALLMODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 REMOVEALLMODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 REMOVEONLY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313 SELECTED _ LANGUAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 SHELL _ OBJECT _ FOLDER. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 SHOW _ PASSWORD _ DIALOG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 SRCDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314 SRCDISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 SUPPORTDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 SYSINFO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315 SYSPROCESSORINFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320 TARGETDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 TARGETDISK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 UNINST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322 UNINSTALLKEY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 UNINSTALL _ DISPLAYNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 UNINSTALL _ STRING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 UPDATEMODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324 WINDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 WINDISK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 WINSYSDIR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 WINSYSDIR64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 WINSYSDISK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 8 Preprocessor Directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327 #define . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328 #elif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329 #elifdef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
34page
Table of Contents xxxiv InstallShield InstallScript Language Reference Guide #error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 #if. . .#else. . .#endif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330 #ifdef and #ifndef . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331 #include. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332 #undef. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333 9 E ve nt H an dl er s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335 Event Handler Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337 Component Event Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 Global Event Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 Initialization Handlers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 OnCheckMediaPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 OnSetTARGETDIR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341 OnSetUpdateMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342 Before Move Data Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343 OnAdminInstallUIBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 OnAdvertisementBefore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 OnAppSearch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 OnBegin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 OnCCPSearch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 OnFirstUIBefore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 OnIISInitialize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 OnMaintUIBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 OnPatchUIBefore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 OnResumeUIBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 OnSQLBatch Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 OnSQLComponentInstalled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349 OnSQLComponentUninstalled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 OnSQLLogin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 OnSQLServerInitialize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 OnSQLServerInitializeMaint. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350 OnUpdateUIBefore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 OnFilterComponents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 OnXMLInitialize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 Move Data Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 OnCustomizeUninstInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 OnGeneratedMSIScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 OnGeneratingMSIScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 OnIISComponentInstalled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 OnIISVRootUninstalling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355 OnInstalledFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
35page
Table of Contents InstallShield InstallScript Language Reference Guide xxxv OnInstalledFontFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 OnInstallFilesActionBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 OnInstallFilesActionAfter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 OnInstallingFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 OnMoved . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357 OnMoveData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 OnMoving . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 OnNetApiCreateUserAccount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358 OnSQLBatch Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 OnSQLComponentInstalled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 OnSQLComponentUninstalled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 OnUninstalledFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 OnUninstallingFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 OnUninstallingDIFxDriverFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360 OnUninstallingFontFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 OnXMLComponentInstalled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361 OnXMLComponentUninstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362 After Data Move Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 OnIISUninitialize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 OnXMLUninitialize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 OnFirstUIAfter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 OnMaintUIAfter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 OnUpdateUIAfter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 OnAdminInstallUIAfter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365 OnPatchUIAfter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 OnResumeUIAfter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 OnAdvertisementAfter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 OnEnd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 Feature Event Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 OnInstalling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 OnInstalled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 OnUnInstalled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 OnUnInstalling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 Miscellaneous Event Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370 OnAbort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 OnAdminPatchUIAfter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 OnAdminPatchUIBefore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 OnCanceling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373 OnComponentError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 OnDIFxLogCallback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374 OnError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
36page
Table of Contents xxxvi InstallShield InstallScript Language Reference Guide OnException. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375 OnFileError. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 OnFilesInUse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376 OnHelp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 OnInternetError. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377 OnLaunchAppAndWaitCallback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378 OnMsiSilentInstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 OnOutOfDiskSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 OnRebooted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 OnResolveSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379 OnSelfRegistrationError. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 OnUninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 OnUpdateService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 OnWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 OnFileLocked . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 OnFileReadOnly. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382 OnRemovingSharedFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383 OnNextDisk. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 OnMD5Error. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385 Advanced Event Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386 OnShowUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 OnUninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388 10 Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389 Using Built-In Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390 Built-In Functions by Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391 Batch File Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393 Ez Batch File Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 Advanced Batch File Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 Built-In Dialog Box Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395 Component Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 Configuration File Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396 Ez Config.sys File Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Advanced Configuration File Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397 Custom Dialog Box Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398 Device Driver Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400 Extensibility Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
37page
Table of Contents InstallShield InstallScript Language Reference Guide xxxvii Feature Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401 Script-Created Feature Set vs. File Media Library. . . . . . . . . . . . . . . . . . . . . . . . . . . . 402 File Media Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 File/Directory Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Information Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 Initialization File Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406 List Processing Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407 Log File Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408 Long File Name Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 Miscellaneous Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409 Path Buffer Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410 Registry Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 Sd Dialog Box Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412 Shared and Locked File Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416 Shell Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 Special Registry-Related Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417 String Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420 Text Substitutions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 Uninstallation Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 Update Service Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422 Version-Checking Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423 Visual Interface Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424 Windows Installer Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 Windows Installer API Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425 Windows Installer API Functions Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432 11 Operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435 Address Operator (&) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 Append to Path Operator (^) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436 Arithmetic Operators (+, -, *, /) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 Arithmetic Operator Precedence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437 Binary Arithmetic Operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438 Unary Arithmetic Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439 Assignment Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
38page
Table of Contents xxxviii InstallShield InstallScript Language Reference Guide Bit Operators (&, |, ~, ^, <<, >>) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 BYREF Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442 BYVAL Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 Concatenate Operator (+) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443 Indirection Operator (*) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 Logical Operators (&&, ||, !) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444 Member Operator (.) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445 Relational Operators (<, >, =, <=, >=, !=) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446 Relational Operator Precedence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447 String Operators (^, +, %). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448 Structure Pointer Operator (->). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 Find String Operator (%) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449 12 Objects and Object Handlers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 Err Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451 Objects Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453 Reboot Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454 TextSub Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454 Object Handlers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455 InitProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 ReadProperties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 WriteProperties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456 Exception Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457 A Built-In Functions (A-D) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 AddFolderIcon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459 AddFolderIcon Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 AddFolderIcon Example 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463 AddFolderIcon Example 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 AddFolderIcon Example 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 AddProfString. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 AddProfString Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 AdminAskPath. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472 AskDestPath. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 AskDestPath Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
39page
Table of Contents InstallShield InstallScript Language Reference Guide xxxix AskOptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477 AskOptions Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480 AskPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482 AskPath Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485 AskText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486 AskText Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488 AskYesNo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488 AskYesNo Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490 BatchAdd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491 BatchAdd Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495 BatchDeleteEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498 BatchDeleteEx Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500 BatchFileLoad. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502 BatchFileLoad Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503 BatchFileSave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505 BatchFileSave Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507 BatchFind. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509 BatchFind Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510 BatchGetFileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512 BatchGetFileName Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513 BatchMoveEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514 BatchMoveEx Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517 BatchSetFileName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518 BatchSetFileName Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519 CalculateAndAddFileCost. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521 CallDLLFx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522 CallDLLFx Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523 ChangeDirectory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524 ChangeDirectory Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526 CharReplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527 CloseFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529 CloseFile Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529 CmdGetHwndDlg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531 CmdGetHwndDlg Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532 CoCreateObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
40page
Table of Contents xl InstallShield InstallScript Language Reference Guide CoCreateObjectDotNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536 CoGetObject. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537 CoGetObject Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538 ConfigAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539 ConfigAdd Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541 ConfigDelete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542 ConfigDelete Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543 ConfigFileLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545 ConfigFileLoad Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546 ConfigFileSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548 ConfigFileSave Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549 ConfigFind . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551 ConfigFind Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554 ConfigGetFileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555 ConfigGetFileName Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557 ConfigGetInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559 ConfigGetInt Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560 ConfigMove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562 ConfigMove Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563 ConfigSetFileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565 ConfigSetFileName Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566 ConfigSetInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568 ConfigSetInt Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569 ConvertSizeToUnits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571 ConvertWinHighLowSizeToISHighLowSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572 CopyBytes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573 CopyBytes Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 CopyCHARArrayToISStringArray. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575 CopyFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576 CopyFile Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579 CreateDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580 CreateDir Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581 CreateFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583 CreateFile Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
41page
Table of Contents InstallShield InstallScript Language Reference Guide xli CreateInstallationInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586 CreateObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587 CreateProgramFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588 CreateProgramFolder Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589 CreateRegistrySet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590 CreateRegistrySet Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591 CreateShellObjects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593 CreateShellObjects Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594 CtrlClear. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595 CtrlClear Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596 CtrlDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599 CtrlDir Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600 CtrlGetCurSel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603 CtrlGetCurSel Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604 CtrlGetMLEText. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608 CtrlGetMLEText Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609 CtrlGetMultCurSel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613 CtrlGetMultCurSel Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614 CtrlGetState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618 CtrlGetState Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619 CtrlGetSubCommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623 CtrlGetSubCommand Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623 CtrlGetText. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627 CtrlGetText Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627 CtrlPGroups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630 CtrlPGroups Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631 CtrlSelectText. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634 CtrlSelectText Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635 CtrlSetCurSel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638 CtrlSetCurSel Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639 CtrlSetFont. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643 CtrlSetFont Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643 CtrlSetList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647 CtrlSetList Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648 CtrlSetMLEText. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
42page
Table of Contents xlii InstallShield InstallScript Language Reference Guide CtrlSetMLEText Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654 CtrlSetMultCurSel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658 CtrlSetMultCurSel Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659 CtrlSetState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663 CtrlSetState Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664 CtrlSetText. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668 CtrlSetText Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669 DefineDialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672 DefineDialog Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675 DeinstallSetReference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678 DeinstallSetReference Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680 DeinstallStart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683 DeinstallStart Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685 Delay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688 Delay Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688 DeleteCHARArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689 DeleteDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690 DeleteDir Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691 DeleteFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692 DeleteFile Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694 DeleteFolderIcon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696 DeleteFolderIcon Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696 DeleteProgramFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698 DeleteProgramFolder Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699 DialogSetFont. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700 DialogSetInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701 DialogSetInfo Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705 Dialog Styles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706 CHECKBOX Dialog Style. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707 CHECKBOX95 Dialog Style. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708 CHECKMARK Dialog Style. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709 CHECKLINE Dialog Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710 DIFxDriverPackageGetPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710 DIFxDriverPackageInstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712 DIFxDriverPackagePreinstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715
43page
Table of Contents InstallShield InstallScript Language Reference Guide xliii DIFxDriverPackageUninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718 Disable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721 Disable Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724 Do. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725 Do Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727 DoInstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728 DoInstall Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732 B Built-In Functions (E-G) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735 Enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735 Enable Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738 EndCurrentDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739 EndDialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740 EndDialog Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741 EnterDisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744 EnterDisk Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745 EnterPassword. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 746 ExistsDir. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747 ExistsDir Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748 ExistsDisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749 ExistsDisk Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750 EzBatchAddPath. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751 EzBatchAddPath Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752 EzBatchAddString. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754 EzBatchAddString Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756 EzBatchReplace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759 EzBatchReplace Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760 EzConfigAddDriver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762 EzConfigAddDriver Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763 EzConfigAddString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765 EzConfigAddString Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767 EzConfigGetValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770 EzConfigGetValue Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771 EzConfigSetValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772 EzConfigSetValue Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773
44page
Table of Contents xliv InstallShield InstallScript Language Reference Guide EzDefineDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774 EzDefineDialog Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776 FeatureAddCost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778 FeatureAddItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780 FeatureAddItem Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783 FeatureAddUninstallCost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784 FeatureCompareSizeRequired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786 FeatureCompareSizeRequired Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789 FeatureDialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791 FeatureDialog Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793 FeatureError. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794 FeatureError Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797 FeatureErrorInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799 FeatureErrorInfo Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 800 FeatureFileEnum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802 FeatureFileEnum Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 804 FeatureFileInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 806 FeatureFileInfo Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 811 FeatureFilterLanguage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815 FeatureFilterLanguage Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817 FeatureFilterOS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 819 FeatureFilterOS Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822 FeatureGetCost. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824 FeatureGetCost Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825 FeatureGetCostEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826 FeatureGetData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828 FeatureGetData Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831 FeatureGetItemSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 832 FeatureGetItemSize Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833 FeatureGetTotalCost. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835 FeatureInitialize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 836 FeatureInitialize Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 838 FeatureIsItemSelected. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839 FeatureIsItemSelected Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 840
45page
Table of Contents InstallShield InstallScript Language Reference Guide xlv FeatureListItems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842 FeatureListItems Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843 FeatureLoadTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844 FeatureMoveData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845 FeatureMoveData Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846 FeaturePatch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 852 FeatureReinstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 853 FeatureRemoveAll. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 854 FeatureRemoveAllInLogOnly. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 855 FeatureRemoveAllInMedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 856 FeatureRemoveAllInMediaAndLog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 858 FeatureSaveTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 859 FeatureSelectItem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 860 FeatureSelectItem Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 861 FeatureSelectNew. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862 FeatureSetData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 864 FeatureSetData Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 866 FeatureSetTarget . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 867 FeatureSetTarget Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 869 FeatureSetupTypeEnum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 870 FeatureSetupTypeEnum Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 871 FeatureSetupTypeGetData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 872 FeatureSetupTypeGetData Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 874 FeatureSetupTypeSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 878 FeatureSetupTypeSet Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 879 FeatureSpendCost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 880 FeatureSpendUninstallCost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 881 FeatureStandardSetupTypeSet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 883 FeatureTotalSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 886 FeatureTotalSize Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 888 FeatureTransferData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 890 FeatureUpdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892 FeatureValidate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 893 FeatureValidate Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 894
46page
Table of Contents xlvi InstallShield InstallScript Language Reference Guide FileCompare. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 897 FileCompare Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899 FileDeleteLine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 902 FileDeleteLine Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903 FileGrep. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 906 FileGrep Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907 FileInsertLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 909 FileInsertLine Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 910 FindAllDirs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 912 FindAllDirs Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 913 FindAllFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 915 FindAllFiles Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 916 FindFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 919 FindFile Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 920 FindWindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 921 FindWindow Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922 FormatMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 924 GetAndAddAllFilesCost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 924 GetAndAddFileCost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 925 GetCHARArrayFromISStringArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 927 GetCurrentDialogName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 928 GetCurrentDir. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 929 GetDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 930 GetDir Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 931 GetDisk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 932 GetDisk Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 933 GetDiskInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 934 GetDiskSpace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 936 GetDiskSpace Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 937 GetDiskSpaceEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 939 GetDiskSpaceEx Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 941 GetEnvVar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 GetEnvVar Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 GetExtendedErrInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944
47page
Table of Contents InstallShield InstallScript Language Reference Guide xlvii GetExtents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944 GetExtents Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945 GetFileInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 946 GetFileInfo Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 950 GetFolderNameList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 952 GetFolderNameList Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 955 GetFont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 956 GetFont Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 958 GetLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 961 GetLine Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 962 GetMemFree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 963 GetMemFree Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 964 GetObject. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 966 GetObjectByIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 967 GetObjectCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 968 GetProfInt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 969 GetProfInt Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 971 GetProfSectionKeyCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972 GetProfString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 972 GetProfString Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 975 GetProfStringList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976 GetProfStringList Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977 GetSystemInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 979 GetSystemInfo Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 985 GetTrueTypeFontFileInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 988 GetUpdateStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 989 GetUpdateStatusReboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990 GetValidDrivesList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 990 GetValidDrivesList Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 992 GetWindowHandle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 993 GetWindowHandle Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994 C Built-In Functions (H-P) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997 Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997 Handler Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 999
48page
Table of Contents xlviii InstallShield InstallScript Language Reference Guide HIBYTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1001 HIWORD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1002 HIWORD Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003 InstallationInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004 InstallationInfo Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1006 Is. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1009 Is Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1014 ISCompareServicePack. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1016 ISCompareServicePack Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1017 ISDeterminePlatform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1018 IsEmpty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1019 IsEmpty Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1019 IsObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1020 LaunchApp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1021 LaunchApp Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1021 LaunchAppAndWait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1022 LaunchAppAndWait Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027 LaunchAppAndWaitInitStartupInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1029 ListAddItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1031 ListAddItem Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1032 ListAddList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1034 ListAddString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1035 ListAddString Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1036 ListAppendFromArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1038 ListAppendToArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039 ListConvertNumToStr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1040 ListConvertStrToNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1041 ListCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1042 ListCount Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1043 ListCreate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1044 ListCreate Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1046 ListCurrentItem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1047 ListCurrentItem Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1048 ListCurrentString. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1049
49page
Table of Contents InstallShield InstallScript Language Reference Guide xlix ListCurrentString Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1050 ListDeleteAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1051 ListDeleteItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1052 ListDeleteItem Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1053 ListDeleteString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1055 ListDeleteString Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056 ListDestroy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1058 ListDestroy Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1059 ListFindItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1060 ListFindItem Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1061 ListFindString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1063 ListFindString Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1064 ListGetFirstItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1066 ListGetFirstItem Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1067 ListGetFirstString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1069 ListGetFirstString Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1069 ListGetIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1071 ListGetNextItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1072 ListGetNextItem Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1073 ListGetNextString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1075 ListGetNextString Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1076 ListGetType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1078 ListGetType Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1078 ListReadFromFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1079 ListReadFromFile Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1080 ListSetCurrentItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1082 ListSetCurrentItem Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1083 ListSetCurrentString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1085 ListSetCurrentString Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1086 ListSetIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1088 ListSetIndex Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1089 ListValid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1091 ListValid Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1092 ListValidType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1093 ListValidType Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1094
50page
Table of Contents l InstallShield InstallScript Language Reference Guide ListWriteToFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1096 ListWriteToFile Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1096 ListWriteToFileEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1098 LoadStringFromStringTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1099 LOBYTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1100 LogReadCustomNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1101 LogReadCustomString. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1103 LogWriteCustomNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1104 LogWriteCustomString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1106 LongPathFromShortPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107 LongPathFromShortPath Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1108 LongPathToQuote. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1109 LongPathToQuote Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1111 LongPathToShortPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1113 LongPathToShortPath Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1114 LOWORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115 LOWORD Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1115 MaintenanceStart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1116 MediaGetData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1120 MediaGetDataEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1120 MessageBeep. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1123 MessageBeep Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1124 MessageBox. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1125 MessageBox Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1126 MessageBoxEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1127 NumToStr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1129 NumToStr Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1130 OpenFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1131 OpenFile Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1132 OpenFileMode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1134 OpenFileMode Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1136 ParsePath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1138 ParsePath Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1140 ParseUrl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1141
51page
Table of Contents InstallShield InstallScript Language Reference Guide li ParseUrl Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1142 PathAdd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1143 PathAdd Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1144 PathDelete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1146 PathDelete Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1147 PathFind. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1149 PathFind Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1151 PathGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1153 PathGet Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1154 PathMove. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1156 PathMove Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1157 PathSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1159 PathSet Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1160 PlaceBitmap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1162 PlaceBitmap Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1167 PlaceWindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1169 PlaceWindow Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1171 PlayMMedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1172 PlayMMedia Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1173 PostShowComponentDlg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1175 PreShowComponentDlg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1176 ProgDefGroupType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1177 ProgDefGroupType Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178 D Built-In Functions (Q-R) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1181 QueryProgItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1181 QueryProgItem Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1183 QueryShellMgr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1185 QueryShellMgr Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1186 ReadArrayProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1187 ReadBoolProperty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1188 ReadBytes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1189 ReadBytes Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1190 ReadNumberProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1192 ReadStringProperty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1193
52page
Table of Contents lii InstallShield InstallScript Language Reference Guide RebootDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1194 RebootDialog Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1196 RegDBConnectRegistry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1196 RegDBConnectRegistry Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1199 RegDBCopyKeys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1201 RegDBCopyValues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1203 RegDBCreateKeyEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1205 RegDBCreateKeyEx Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1207 RegDBDeleteKey. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1209 RegDBDeleteKey Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1211 RegDBDeleteValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1212 RegDBDeleteValue Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1213 RegDBDisConnectRegistry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1215 RegDBDisConnectRegistry Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1216 RegDBGetAppInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1218 RegDBGetAppInfo Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1221 RegDBGetDefaultRoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1223 RegDBGetItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1223 RegDBGetItem Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1228 RegDBGetKeyValueEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1230 RegDBGetKeyValueEx Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1232 RegDBGetUninstCmdLine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1234 RegDBKeyExist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1236 RegDBKeyExist Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1237 RegDBQueryKey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1239 RegDBQueryKey Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1241 RegDBQueryKeyCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1242 RegDBQueryStringMultiStringCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1244 RegDBSetAppInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1246 RegDBSetAppInfo Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1248 RegDBSetDefaultRoot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1250 RegDBSetDefaultRoot Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1251 RegDBSetItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1253 RegDBSetItem Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1257
53page
Table of Contents InstallShield InstallScript Language Reference Guide liii RegDBSetKeyValueEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1259 RegDBSetKeyValueEx Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1262 RegDBSetVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1264 RegisterFontResource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1265 RegisterFontResource Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1268 ReleaseDialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1268 ReleaseDialog Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1269 RenameFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1272 RenameFile Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1273 ReplaceFolderIcon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1275 ReplaceFolderIcon Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1277 ReplaceProfString. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1278 ReplaceProfString Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1281 Resize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1282 RGB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1283 RGB Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1283 E Built-In Functions (S-T). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1285 SdAskDestPath. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1285 SdAskDestPath Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1287 SdAskDestPath2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1288 SdAskDestPath2 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1290 SdAskOptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1291 SdAskOptions Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1293 SdAskOptionsList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1294 SdAskOptionsList Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1296 SdBitmap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1297 SdBitmap Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1299 SdConfirmNewDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1300 SdConfirmNewDir Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1301 SdConfirmRegistration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1303 SdConfirmRegistration Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1304 SdCustomerInformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1305 SdCustomerInformation Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1308 SdCustomerInformationEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1309
54page
Table of Contents liv InstallShield InstallScript Language Reference Guide SdCustomerInformationEx Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1312 SdDiskSpaceRequirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1314 SdDiskSpaceRequirements Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1314 SdDisplayTopics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1315 SdDisplayTopics Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1317 SdExceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1318 SdExceptions Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1319 SdFeatureDialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1321 SdFeatureDialog Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1324 SdFeatureDialog2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1324 SdFeatureDialog2 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1328 SdFeatureDialogAdv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1328 SdFeatureDialogAdv Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1332 SdFeatureMult . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1332 SdFeatureMult Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1336 SdFeatureTree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1336 SdFeatureTree Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1339 SdFilesInUse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1340 SdFilesInUse Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1341 SdFinish. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 SdFinish Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1345 SdFinishEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1346 SdFinishEx Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1347 SdFinishReboot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1348 SdFinishReboot Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1350 SdFinishUpdate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1351 SdFinishUpdateEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1353 SdFinishUpdateReboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1355 SdFinishUpdateReboot Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1357 SdInit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1358 SdInit Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1358 SdLicense . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1359 SdLicense Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1361 SdLicense2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1362 SdLicense2 Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1364
55page
Table of Contents InstallShield InstallScript Language Reference Guide lv SdLicense2Rtf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1365 SdLicense2Rtf Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1366 SdLicenseRtf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1367 SdLicenseRtf Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1369 SdLoadString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1370 SdLoadString Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1370 SdLogonUserBrowse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1371 SdLogonUserCreateUser. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1372 SdLogonUserInformation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1372 SdLogonUserListGroups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1373 SdLogonUserListServers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1373 SdLogonUserListUsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1374 SdMakeName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1374 SdMakeName Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1375 SdOptionsButtons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1380 SdOptionsButtons Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1382 SdOutOfDiskSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1384 SdPatchWelcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1385 SdPatchWelcome Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1386 SdProductName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1387 SdProductName Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1388 SdRegisterUser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1389 SdRegisterUser Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1391 SdRegisterUserEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1392 SdRegisterUserEx Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1394 SdSelectFolder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1395 SdSelectFolder Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1396 SdSetupCompleteError . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1396 SdSetupCompleteError Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1398 SdSetupType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1398 SdSetupType Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1400 SdSetupType2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1401 SdSetupType2 Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1403 SdSetupTypeEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1405
56page
Table of Contents lvi InstallShield InstallScript Language Reference Guide SdSetupTypeEx Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1406 SdShowAnyDialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1407 SdShowAnyDialog Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1409 SdShowDlgEdit1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1409 SdShowDlgEdit1 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1411 SdShowDlgEdit2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1412 SdShowDlgEdit2 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1414 SdShowDlgEdit3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1415 SdShowDlgEdit3 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1417 SdShowFileMods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1418 SdShowFileMods Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1420 SdShowInfoList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1421 SdShowInfoList Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1422 SdShowMsg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1424 SdShowMsg Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1425 SdStartCopy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1426 SdStartCopy Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1428 SdStartCopy2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1430 SdStartCopy2 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1431 SdSubstituteProductInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1433 SdWelcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1434 SdWelcome Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1435 SdWelcomeMaint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1436 SdWelcomeMaint Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1437 SeekBytes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1439 SeekBytes Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1440 SelectDir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1442 SelectDir Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1444 SelectDirEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1445 SelectDirEx Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1448 SelectFolder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1449 SelectFolder Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1451 SendMessage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1452 SendMessage Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1453 ServiceAddService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1455
57page
Table of Contents InstallShield InstallScript Language Reference Guide lvii ServiceExistsService. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1457 ServiceGetServiceState. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1457 ServiceInitParams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1459 ServiceRemoveService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1461 ServiceStartService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1462 ServiceStopService. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1463 SetColor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1464 SetColor Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1467 SetDialogTitle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1468 SetDialogTitle Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1469 SetDisplayEffect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1470 SetDisplayEffect Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1472 SetErrorMsg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1475 SetErrorMsg Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1475 SetErrorTitle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1476 SetErrorTitle Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1477 SetExtendedErrInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1478 SetFileInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1479 SetFileInfo Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1481 SetFont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1483 SetFont Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1484 SetInstallationInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1486 SetStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1487 SetStatusEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1488 SetStatusExStaticText. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1489 SetStatusWindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1490 SetStatusWindow Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1492 SetTitle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1493 SetTitle Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1496 SetUpdateStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1497 SetUpdateStatusReboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1497 SetupType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1497 SetupType Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1500 SetupType2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1502
58page
Table of Contents lviii InstallShield InstallScript Language Reference Guide SetupType2 Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1504 ShowObjWizardPages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1506 ShowProgramFolder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1507 ShowProgramFolder Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1508 ShowWindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1509 SilentReadData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1511 SilentReadData Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1513 SilentWriteData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1518 SilentWriteData Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1520 SizeOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1525 SizeWindow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1525 SizeWindow Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1526 Sprintf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1527 Sprintf Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1528 SprintfBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1529 SprintfBox Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1532 SprintfMsiLog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1533 SQLBrowse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1534 SQLRTConnect2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1535 SQLRTGetConnections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1536 SQLRTGetConnectionAuthentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1537 SQLRTGetConnectionInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1537 SQLRTGetLastError. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1538 SQLRTInitialize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1539 SQLRTPutConnectionInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1540 SQLServerLogin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1541 SQLServerSelect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1542 SQLServerSelectLogin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1543 StatusUpdate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1545 StatusUpdate Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1547 StrAddLastSlash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1549 StrCompare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1549 StrCompare Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1550
59page
Table of Contents InstallShield InstallScript Language Reference Guide lix StreamFileFromBinary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1551 StrFind. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1552 StrFind Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1552 StrFindEx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1553 StrGetTokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1554 StrGetTokens Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1556 StrLength. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1558 StrLength Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1558 StrLengthChars. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1559 StrLengthChars Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1560 StrPutTokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1561 StrRemoveLastSlash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1562 StrRemoveLastSlash Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1564 StrReplace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1565 StrSub. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1565 StrSub Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1566 STRTOCHAR. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1568 StrToLower . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1569 StrToLower Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1569 StrToNum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1571 StrToNum Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1572 StrToNumHex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1573 StrToUpper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1574 StrToUpper Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1575 System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1576 System Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1577 TextSubGetValue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1578 TextSubGetValue Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1579 TextSubParseTextSub. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1580 TextSubParseTextSub Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1581 TextSubSetValue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1582 TextSubSetValue Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1583 TTextSubSubstituteextSubSubstitute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1584 TextSubSubstitute Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1585
60page
Table of Contents lx InstallShield InstallScript Language Reference Guide F Built-In Functions (U-Z). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 87 UninstallApplication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1587 UnUseDLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1588 UnUseDLL Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1589 UpdateServiceCheckForUpdates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1592 UpdateServiceCreateShortcut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1593 UpdateServiceEnableUpdateManagerInstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1594 UpdateServiceGetAgentTarget. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1595 UpdateServiceRegisterProduct. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1596 UpdateServiceRegisterProductEx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1598 UpdateServiceSetHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1599 UpdateServiceSetLanguage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1600 UpdateServiceSetLanguage Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1601 UseDLL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1602 UseDLL Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1604 VarInit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1606 VarRestore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1607 VarRestore Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1609 VarSave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1610 VarSave Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1613 VarSave Stack Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1614 VerCompare. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1616 VerCompare Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1616 VerFindFileVersion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1619 VerFindFileVersion Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1620 VerGetFileLanguages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1622 VerGetFileLanguages Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1623 VerGetFileVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1624 VerGetFileVersion Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1625 VerProductCompareVersions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1626 VerProductGetInstalledVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1628 VerProductIsVersionSupported. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1628 VerProductNumToStr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1629 VerProductStrToNum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1630
61page
Table of Contents InstallShield InstallScript Language Reference Guide lxi VerProductVerFromVerParts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1631 VerProductVerPartsFromVer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1632 VerSearchAndUpdateFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1633 VerSearchAndUpdateFile Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1636 VerUpdateFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1638 VerUpdateFile Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1643 WaitOnDialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1644 WaitOnDialog Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1645 Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1648 Welcome Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1649 WizardDirection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1650 WriteArrayProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1651 WriteBoolProperty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1652 WriteBytes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1653 WriteBytes Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1654 WriteLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1656 WriteLine Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1657 WriteNumberProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1659 WriteProfInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1660 WriteProfInt Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1662 WriteProfString. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1663 WriteProfString Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1664 WriteStringProperty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1665 XCopyFile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1666 XCopyFile Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1670 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1673
62page
Table of Contents lxii InstallShield InstallScript Language Reference Guide
63page
InstallShield InstallScript Language Reference Guide 1 1 INSTALLSCRIPT LANGUAGE REFERENCE InstallShield makes designing your installation easy with InstallScript, a simple but powerful programming language. InstallScript is similar to the C language. It has a defined format and regulated syntax. It uses certain data types, each with specific properties. It also allows you to create custom functions. InstallScript, however, does not provide the full range of programming functionality that C does. InstallScript was designed to do one thing—create installations. And it does so better than any programming language in the world. Regardless of your programming background, you can quickly learn to build an installation with InstallScript. PROJECT Some InstallScript functions, events, and variables are limited to specific installation project types. Table 1-1: InstallScript Language Reference Section Description Integrated Compiler Provides general information about the InstallScript integrated compiler. Command-Line Compiler Contains details about the InstallScript command- line compiler that can be invoked from the DOS prompt or from a DOS batch file. Setup Scripts Introduces you to the InstallScript language and the structure of a script.
64page
Chapter 1: InstallScript Language Reference 2 InstallShield InstallScript Language Reference Guide N OTE Some of the functions that were available in InstallShield Professional are deprecated in later versions of InstallShield. To view a list of the functions, see Unsupported Functions. Language Keywords Presents background about language keywords, which are words InstallScript uses as commands in the script. Language keywords are interpreted by the InstallScript compiler to perform some action, or are considered part of a statement. Predefined Constants Identifies and describes each of the predefined constants reserved by InstallScript. These constants represent specific literal values that are passed to and returned by built-in functions. Predefined Script Variables Contains information about script variables that you can use with InstallScript. Data Types and Predefined Structures Contains content about the data types and predefined structures supported in InstallScript. Preprocessor Directives Discusses preprocessor directives, which are instructions to the InstallScript compiler that are executed as the script is compiled. Preprocessor directives can instruct the compiler to include other source files in the compilation, to define constants, to include or exclude statements based on compile-time conditions, and to display a user- defined error message. Flow Control Contains information on how to control the flow of execution within scripts. Event Handlers InstallScript project installation programs are driven by the InstallScript engine, which generates a series of events in a specific order. Functions Describes the different types of functions that you can use in your installation scripts; also includes details about—and examples of—each of the built- in functions available in InstallScript. Operators Contains information about supported operators in InstallScript. Objects and Object Handlers Contains information about the objects that InstallScript supports and how to separate error handling from the rest of your script code. Table 1-1: InstallScript Language Reference (cont.) Section Description
65page
Chapter 1: InstallScript Language Reference Integrated Compiler InstallShield InstallScript Language Reference Guide 3 Because the InstallShield Help Library is designed to interact with InstallShield, it is recommended that you open the help from within InstallShield. Copying the help files to another folder or system causes many of its features to work incorrectly. Integrated Compiler The integrated InstallScript compiler can be started from the InstallShield interface by selecting Compile from the Build menu. Compiler messages are displayed in the Output window. Command-Line Compiler In addition to the integrated compiler, which is executed from the interface, InstallShield includes a command-line compiler that can be invoked from the DOS prompt or from a DOS batch file. This program, called Compile.exe, is located in the InstallShield folder's System subfolder. After a setup project has been completely defined, Compile.exe can be used to compile the setup script using different options than the integrated compile step in the InstallShield designer. NOTE When you build the media using ISCmdBld.exe the build engine automatically compiles your script, therefore you do not need to use Compile.exe directly unless you want to use compiler options different from those specified in the InstallShield designer for the project. Syntax Compile script_file [iswi_obl_file] [isrt_obl_file] [ifx_obl_file] switches You can pass any or all of your command line parameters to Compile.exe in the form of a command file. To specify a command file to Compile.exe, use the following syntax: Compile @command_file In this example, command_file is the name of a text file, including any extension. You can specify an absolute or relative path with the filename. You can specify all or part of the command line in a command file. You can use more than one command file in a Compile command. Compile.exe accepts the command file's input as if it were specified in that location on the command line. In the command file, each parameter must begin and end on the same line—you cannot use the backslash (\) to combine a parameter across two lines. In the command
66page
Chapter 1: InstallScript Language Reference Command-Line Compiler 4 InstallShield InstallScript Language Reference Guide file, arguments can be separated by spaces or tabs (as on the command line) and by newline (\n) characters. Parameters Switches The following switches can be passed to the compiler. These switches are optional, except that you must specify the location of certain folders using the -i switch as noted in the -i section below, unless you use the -c or -l switch. Table 1-2: Command Line Compiler Parameter Description script_file Specifies the name of the setup script. Note the following: • The filename can include a drive designation and an absolute or relative path. If the filename is unqualified, the compiler will search for the script in the current directory of the current drive. • If the specified setup script uses #include directives to include other files in the setup, and if the filenames specified by #include statements do not include a path, you must specify the location of those files with the -i switch unless they reside in the current directory. Note that included files may themselves specify #include directives; be sure the -i switch specifies a search path that can be used to find all included source files. • Long path and file names must be enclosed in double quotation marks. • By default, the setup script created as part of a new InstallShield project is named setup.rul. iswi _ obl _ file Specifies the fully qualified name of Iswi.obl or, if the -libpath switch is used to specify the path, just the filename. Iswi.obl is located in the InstallShield folder's Script\Iswi\Lib subfolder. Required unless you use the -c or -l switch. isrt _ obl _ file Specifies the fully qualified name of Isrt.obl or, if the -libpath switch is used to specify the path, just the filename. Isrt.obl is located in the InstallShield folder's Script\Isrt\Lib subfolder. Required unless you use the -c or -l switch. ifx _ obl _ file Specifies the fully qualified name of Ifx.obl or—if the -libpath switch is used to specify the path—just the filename. Ifx.obl is located in the InstallShield folder's Script\Ifx\Lib subfolder. This is required unless you use the -c or -l switch. Table 1-3: Switches Switch Description /c or -c Compiles the script file without linking it to any existing library file. This will create an .obs file (rather than the .inx file created by compiling without the -c switch). Creating an .obs file is an intermediate step in creating a library file.
67page
Chapter 1: InstallScript Language Reference Command-Line Compiler InstallShield InstallScript Language Reference Guide 5 /d or -d<identifier=value> Defines a constant. This switch must be followed by an expression in the following format: identifier=value The identifier must be a valid InstallScript identifier; the value must be a constant. No space is permitted between the switch and the expression or within the expression. /e or -e Specifies the maximum number of error messages. The default value is 50. When the maximum number of error messages has been generated, compilation stops. /g or -g Specifies that a debugging information file should be produced. This file is given the name of the setup and extension .dbg. /gi or -gi Specifies that debugging information should be included in the compiled script file, so a debugging information file is not needed. This option makes the compiled script larger and the setup slower, and makes it easier for others to reverse engineer your code, so it should typically not be used when creating your final setup for distribution to end users. /i or -i<search path> Specifies a search path—a list of paths, each separated by a semicolon—that identifies the directories to search for source files that have been included in the setup via #include statements. The following folders must be specified (unless you use the -c or -l switch) or a compiler error will occur: • the InstallShield folder's Script\Ifx\Include subfolder • the InstallShield folder's Script\Isrt\Include subfolder Long path names must be enclosed in double quotation marks. /libpath or -libpath<path> Specifies a single path that identifies a directory to search for Ifx.obl, Isrt.obl, or a custom library file. To specify multiple directories, use the -libpath switch multiple times, as in the example at the end of this help topic. Long path names must be enclosed in double quotation marks. Table 1-3: Switches (cont.) Switch Description
68page
Chapter 1: InstallScript Language Reference Command-Line Compiler 6 InstallShield InstallScript Language Reference Guide Comments • When specifying filenames, you can use either short or long filenames; however, long filenames must be enclosed within double quotation marks. • If you specify a relative path to a filename (for example ..\..\My Functions), that path must be relative to the current directory of the current drive at the time that you invoke the compiler. Example The following command line for an InstallScript project compiles the script Setup.rul that is located in the C:\My InstallShield 12 Projects\My InstallScript Project\script files folder: /o or -o<compiled script filename> Specifies the filename to assign to the compiled script. Note the following: • The filename can include a drive designation and an absolute or relative path. If a path is not specified, the compiler will store the compiled script in the current directory. • If this parameter is not specified, the compiled script is given the name of the script file and the extension .inx and is stored in the current directory. • Long path and file names must be enclosed in double quotation marks. /q or -q Suppresses the output of the copyright message and version information. /v or -v Sets the warning level to one of the following values: • 0—Displays no warning messages. • 1—Displays any system warning message that InstallShield is unable to handle. • 2—Displays Level 1 messages, plus a message if string length exceeds the limit. • 3—Displays all warning messages. This is the default setting. /w or -w Specifies the maximum number of warning messages. The default value is 50. When the maximum number of warning messages has been generated, compilation stops. Table 1-3: Switches (cont.) Switch Description
69page
Chapter 1: InstallScript Language Reference Command-Line Compiler InstallShield InstallScript Language Reference Guide 7 "C:\Program Files\Macrovision\IS12\System\compile.exe" "C:\My InstallShield 12 Projects\My InstallScript Project\script files\setup.rul" ifx.obl isrt.obl -libpath"C:\Program Files\Macrovision\IS12\script\ifx\lib" -libpath"C:\Program Files\Macrovision\IS12\script\isrt\lib" -i"C:\Program Files\Macrovision\IS12\script\ifx\include" -i"C:\Program Files\Macrovision\IS12\script\isrt\include" -i"C:\Program Files\Macrovision\IS12\script\include" -i"C:\Program Files\Macrovision\IS12\script\SQLRuntime\Include" -i"C:\Program Files\Macrovision\IS12\script\IISRuntime\Include" -i"CC:\Program Files\Macrovision\IS12\script\XMLRuntime\Include" -i"C:\My InstallShield 12 Projects\My InstallScript Project\script files" The following command line for an InstallScript MSI project compiles the script Setup.rul that is located in the :\My InstallShield 12 Projects\My InstallScript MSI Project\script files folder: "C:\Program Files\Macrovision\IS12\System\compile.exe" "C:\My InstallShield 12 Projects\My InstallScript MSI Project\script files\setup.rul" ISWI.obl isrt.obl -libpath"C:\Program Files\Macrovision\IS12\script\ISWI\lib" -libpath"C:\Program Files\Macrovision\IS12\script\isrt\lib" -i"C:\Program Files\Macrovision\IS12\script\ifx\include" -i"C:\Program Files\Macrovision\IS12\script\isrt\include" -i"C:\Program Files\Macrovision\IS12\script\include" -i"C:\Program Files\Macrovision\IS12\script\SQLRuntime\Include" -i"C:\Program Files\Macrovision\IS12\script\IISRuntime\Include" -i"C:\Program Files\Macrovision\IS12\script\XMLRuntime\Include" -i"C:\My InstallShield 12 Projects\My InstallScript MSI Project\script files"
70page
Chapter 1: InstallScript Language Reference Command-Line Compiler 8 InstallShield InstallScript Language Reference Guide
71page
InstallShield InstallScript Language Reference Guide 9 2 SETUP SCRIPTS A setup script is a collection of event handlers, functions called by those event handlers, and data used by the event handlers and functions. These elements are expressed in the InstallScript Language, a simple but powerful programming language. InstallScript is similar to the C language. It has a defined format and regulated syntax. It uses certain data types, each with specific properties. It also allows you to create custom functions. InstallScript, however, does not provide the full range of programming functionality that C does. InstallScript was designed to do one thing—create setups. And it does this effectively and efficiently. Regardless of your programming background, you can learn quickly to build your setup with InstallScript. InstallShield comes with more than 400 built-in functions that do most of the work for you. Structure of a Script Every script includes declarations and function blocks. Declarations can precede function declarations or appear between a function statement and the begin statement for that function. The general outline of a script is shown below: // Constant definitions, global data declarations, and function declarations // Function blocks
72page
Chapter 2: Setup Scripts Declarations 10 InstallShield InstallScript Language Reference Guide Declarations Every script begins with global data declarations. Here, you define constants and declare each of the global variables and user-defined functions that you will be using. Declarations instruct the InstallScript compiler that the script will be using the listed items at a later time. Declarations also build an association between a function and its attributes or values. You do not need to declare any of the built-in functions, since the InstallScript compiler already recognizes the function names. Below are some examples of constant definitions, data declarations, and function declarations: // Constant definitions #define PRODUCT "InstallShield" #define LIMIT 100 // Variable declarations CHAR cVal; NUMBER nVal; STRING szName; // Function declarations prototype DisplayMsg (NUMBER, STRING); prototype GetName (BYREF STRING); Program Block Program blocks are used in scripts written using InstallShield Professional 5.5 or earlier. A program block cannot be used for an InstallScript custom action or in an event-driven script. The only code that is executed is found in event handlers and entry-point functions. program // In an event-driven script, the program block is optional and remains empty. endprogram Function Block P ROJECT This information applies to InstallScript projects. All functions that have been declared with a prototype statement must be defined in the function block, which follows the keyword endprogram in a setup script.
73page
Chapter 2: Setup Scripts Identifiers InstallShield InstallScript Language Reference Guide 11 Additional global data declarations may be made in the function block, either between the endprogram statement and the first function declaration or between function declarations. However, data declared in the function block is visible only to functions that are defined after the data declaration. Identifiers Identifiers are the names that you create to denote constants, variables, and functions in your script. Observe the following syntax rules when creating identifiers: • An identifier may be of any length, but only the first 63 characters are significant. • The first character of an identifier must be alphabetic (a-z, A-Z) or an underscore. • The remaining characters may be alphabetic (a-z, A-Z), numeric (0-9), or an underscore. • Each identifier must be unique. Be careful not to create an identifier that is a reserved word in InstallScript. Syntax Punctuation Rules Like any programming language, InstallScript has syntax rules that regulate its usage. The basic syntax of InstallScript is similar to that of the C programming language. The following punctuation reminders apply to all sections of the script: • Most statements end with a semicolon (;). This includes many one-word statements, such as end;, exit;, and return;. • Preprocessor statements—such as #define and #include—never end with a semicolon. • The keywords program, endprogram, and begin are placed on separate lines by themselves and receive no punctuation. The function line that begins each function block receives no punctuation. • End a label, such as start: or starthere:, with a colon (:). • Enclose parameter lists within parentheses. Separate multiple parameters with commas. Writing Comments InstallScript gives you two ways to create comments in a script. You can use either method to add explanatory text to your script or to exclude or “comment out” certain parts of your script for testing and debugging purposes.
74page
Chapter 2: Setup Scripts Using White Space 12 InstallShield InstallScript Language Reference Guide CAUTION You can begin comments anywhere in a script—with one exception: Comments cannot be placed on the same line as an #ifdef or #ifndef statement. You must write comments before or after these statements, if necessary. Otherwise, the compiler returns an error. Block of Text One way to create a comment is to enclose a block of text between the character pairs /* and */. This method makes it easy to write a comment over multiple lines: /* This is a line of sample code that shows you * how to use the InstallScript function PlaceBitmap. */ Line by Line The second way is to insert the characters // into a line. The compiler ignores everything to the right of the double slashes on that line only. // This is a line of sample code showing the // InstallScript function PlaceBitmap. Using White Space Like C and other programming languages, InstallScript does not recognize white space (spaces and tabs, carriage returns) except in a string literal. We recommend that you use white space to make your script easier to follow. Code Without White Space For example, the following section of code is dense and difficult to decipher: #define DISK_DRIVE "C:\\" STRING szDrive, svString; NUMBER nSpace, nResult; szDrive = DISK_DRIVE; nSpace = GetDiskSpace(szDrive); nResult = NumToStr(svString, nSpace); if (nResult < 0) then MessageBox("NumToStr failed.", SEVERE); abort; endif; SprintfBox(INFORMATION, "Info", "Disk Space: %s", svString); Code With White Space Adding white space with indentation makes the same code much easier to read:
75page
Chapter 2: Setup Scripts Hungarian Notation InstallShield InstallScript Language Reference Guide 13 #define DISK_DRIVE "C:\\" STRING szDrive, svString; NUMBER nSpace, nResult; szDrive = DISK_DRIVE; nSpace = GetDiskSpace(szDrive); nResult = NumToStr(svString, nSpace); if (nResult < 0) then MessageBox("NumToStr failed.", SEVERE); abort; endif; SprintfBox(INFORMATION, "Info", "Disk Space: %s", svString); Hungarian Notation InstallShield help topics employ an extended form of Hungarian notation—a naming convention that uses short, lowercase prefixes to indicate the data type. For example, iPointSize denotes an integer variable, while szFileName indicates a string variable. Hungarian notation is used in example scripts to indicate the data type of all variables. In function syntax descriptions, Hungarian notation is used for parameter names to indicate the type of data that may be passed in a parameter. For example, the syntax description of BatchDeleteEx shows that it takes two parameters: BatchDeleteEx ( szKey, nOptions ); The first parameter, identified as szKey, could be a string variable or constant. The second, identified as nOptions, could be a number variable or constant. Variable Parameters In those cases where a variable parameter is required, the Language reference employs a special set of two-letter prefixes: • The first letter indicates the data type. • The second character is the letter v, for variable. In the syntax description for GetDir, the first parameter can be a string variable or constant, but the second parameter must be a variable. GetDir ( szPath, svDir ); Functions that require variable parameters generally return data to the caller in those parameters.
76page
Chapter 2: Setup Scripts Hungarian Notation 14 InstallShield InstallScript Language Reference Guide Prefix Table Because Hungarian notation makes it easy to recognize a variable's type, it is strongly recommended that you use Hungarian notation when you create variable names in your own scripts. The table below describes each of the prefixes used in InstallShield. Table 2-1: Prefix Table Prefix Data Type When Used in Function Syntax b Boolean (BOOL) Boolean constant, literal, or variable. bv Boolean (BOOL) Boolean variable only. Constants and literals not allowed. c Character (CHAR) Character constant, literal, or variable. const Constant Constant or literal. Variables not allowed. h Handle (HWND) Handle variable. i Integer (INT) Integer constant, literal, or variable. l Long integer (LONG) Long integer constant, literal, or variable. lv Long integer (LONG) Long integer variable only. Constants and literals not allowed. list List (LIST) List variable. n Number (NUMBER) Number constant, literal, or variable. nv Number (NUMBER) Number variable only. Constants and literals not allowed. p Pointer (POINTER) Pointer variable. pstruct Pointer to a defined structure type Not used. s Short integer (SHORT) Short integer constant, literal, or variable. sz String (STRING) String constant, literal, or variable. sv String (STRING) String variable only. Constants and literals not allowed. struct Defined structure type Not used.
77page
Chapter 2: Setup Scripts Escape Sequences InstallShield InstallScript Language Reference Guide 15 Escape Sequences An escape sequence is a set of characters used to insert into a string certain special characters—such as tabs, carriage returns and quotation marks. Escape sequences in InstallScript are very much like those in C. They begin with a backslash, called an escape character, and the backslash is followed by one or more characters that have special meaning. If the backslash is followed by characters other than those used in an escape sequence, the backslash is ignored. Inserting a Newline Character Into a String A commonly used escape sequence is \n, which inserts a newline character into a string. The string “This is line one, This is line two.” is displayed or printed on a single line. However, the string “This is line one,\nThis is line two.” is displayed or printed as shown below: This is line one, This is line two. NOTE • The \n escape sequence works only in multiline static text fields. For example, you can insert \n in the szQuestion argument of AskText to manually format the string. You can also use \n with MessageBox and SprintfBox. • The newline escape sequence is case sensitive; that is, \N does not insert a newline character. • The percent sign (%) also has a special function in InstallScript; it is used as the first character of a format specifier, which is a sequence of characters that is used with functions such as Sprintf and SprintBox to indicate how the value stored in a variable should be displayed on screen. Supported Escape Sequences The following table lists the escape sequences that are supported by InstallScript: Table 2-2: Supported Escape Sequences Escape Sequence Performs the Following Action \n Inserts a carriage return and a line feed. \' Inserts a single quotation mark in the string. \" Inserts a double quotation mark in the string. \r Inserts a carriage return only. Does not insert a line feed. \t Inserts a tab character.
78page
Chapter 2: Setup Scripts Embedding Quotation Marks 16 InstallShield InstallScript Language Reference Guide Specifying a Universal Naming Convention Path To specify a Universal Naming Convention (UNC) path in an InstallScript string, you must use two backslash escape sequences (that is, four backslashes—\\\\), to create the double backslash at the start of the path. For example, the path \\MyServer\Public\Readme.txt must be specified as follows: "\\\\MyServer\\Public\\Readme.txt" Embedding Quotation Marks You can insert double quotation marks as part of a string literal using one of two methods. If you begin the string literal with double quotation marks, you must use the \" escape character to embed double quotation marks. You can, however, begin the literal with a single quotation mark and then type the double quotation mark: //These two statements will both yield embedded double quotation marks szQuote1 = "Who said, \"Quitters never win\"?"; szQuote2 = 'The same guy who said, "I quit. "'; To embed a single quotation mark, either use the \' escape sequence or open the string literal with double quotation marks: //These two statements will both yield embedded single quotation marks szQuote1 = 'Who said, \'Nice guys finish last\'?'; szQuote2 = "The same guy who said, 'I win.'"; NOTE Your setup scripts must use the standard quotation marks (" and ') found to the right of the semicolon (;) key on the standard U.S. keyboard. Do not use open or closed typographer's quotation marks (“”), such as this help files uses outside of example scripts. \ooo Indicates an ASCII character—not an integer—in octal notation. \xhh Indicates an ASCII character—not an integer—in hexadecimal notation. \\ Inserts a backslash. Table 2-2: Supported Escape Sequences (cont.) Escape Sequence Performs the Following Action
79page
Chapter 2: Setup Scripts Format Specifiers InstallShield InstallScript Language Reference Guide 17 Format Specifiers Format specifiers are used with the functions Sprintf and SprintfBox to control the display of values that are stored in variables. A format specifier begins with a percent sign (%) and is followed by at least one or two characters. Format specifications follow the format shown below: % [-] [#] [0] [width] [.precision] type Each field of a format specification is a single character or number that represents a particular format option. The type field, for example, determines whether Sprintf or SprintfBox interprets the associated argument as a character, a string, or a number. The initial character % and the type field are both required. Items enclosed within brackets are optional. The simplest format specification contains only the percent sign and a type character, for example %s. In the following example, the value of svString is displayed in a message box. The format specifier %s, which is assigned to svFormat, indicates to SprintfBox that the value of svString should be displayed as a string of characters. STRING szTitle, szFormat, szString; szTitle = "Demonstrate format specifiers"; szFormat = "%s"; szString = "This is a string."; SprintfBox(INFORMATION, szTitle, szFormat, szString); The value assigned to svFormat may contain literal characters (including escape sequences) that are to be displayed along with the value of a variable. In the following example, an identifying label is displayed to the left of a number variable: nNumber = 100;. STRING szTitle, szFormat; NUMBER nNumber; szTitle = "Demonstrate format specifiers"; szFormat = "nNumber = %d."; nNumber = 100; SprintfBox(INFORMATION, szTitle, szFormat, nNumber); NOTE To print a percent sign, you must insert two percent signs in the string assigned to svFormat. Assuming that the number to be printed is 100, the following format specification string displays “nNumber = 100%”:
80page
Chapter 2: Setup Scripts Format Specifiers 18 InstallShield InstallScript Language Reference Guide svFormat = "nNumber = %d%%." Each format specifier has a matching variable. The variables are listed from left to right after the string, with the first variable matching the first format specifier in the string, the second variable matching the second format specifier in the string, and so Table 2-3: Format Specifier Fields Field Meaning - If you include a hyphen after the percent character, the output value is aligned left and padded on the right to the width of the field with blanks or zeros. If you omit this field, the output value is right aligned and padded on the left. # Use this symbol to prefix hexadecimal values with 0x (lowercase) or 0X (uppercase). 0 Pads the output value with zeros to fill the field width. If you omit this field, the output value is padded with blanks. width Enter the minimum number of characters you want to place in this field. Type the width field as a non-negative integer. When you enter a width specification, the value is never truncated. If the number of characters in the output value is greater than the width specified, or if you omit the width field, every character of the value is displayed, subject to the value of the precision field. precision Enter the minimum number of digits you want in this field. If the number of digits in the argument is less than the precision value you enter, the output value on the left is padded with zeros. When the number of digits exceeds the precision value, the value is not truncated. If you enter a precision value of zero or omit it entirely, or if the period (.) appears without a number following it, the precision is set to 1. For strings, convert the maximum number of characters. type Format the corresponding argument as a character, a string, or a number. When two format specifier letter combinations are shown, you can use one or the other, but not both at the same time. This is a required field. In this field you must enter one of the following characters: • c—Formats a single character of type CHAR. The Sprintf function ignores a character with a numeric value of zero. • d, i—Formats a single integer of type INT or of type NUMBER. • ld, li—Formats a single signed decimal integer of type LONG. • lx, lX—Formats a single unsigned hexadecimal integer of type LONG. • s—Formats a string (type STRING).
81page
Chapter 2: Setup Scripts Reserved Words InstallShield InstallScript Language Reference Guide 19 on. At run time, InstallShield inserts each variable's contents into the string at the location of its matching format specifier. Reserved Words Reserved words and characters have special meaning in InstallScript and cannot be used except for their intended purposes. InstallScript has the following classes of reserved words: • Functions • Language Keywords • Predefined Constants • System Variables • Event Handlers • Predefined Script Variables
82page
Chapter 2: Setup Scripts Reserved Words 20 InstallShield InstallScript Language Reference Guide
83page
InstallShield InstallScript Language Reference Guide 21 3 LANGUAGE KEYWORDS Language keywords are words InstallScript uses as commands in the script. Language keywords are interpreted by the InstallScript compiler to perform some action, or are considered part of a statement. You cannot use these following keywords for any reason other than their predefined purpose (for example, these keywords cannot be used as variable names). abort When the script encounters an abort statement, the setup terminates. The abort statement is also encountered in the InstallShield default exit handler (OnCanceling) when the end user exits the setup program before it has completed by pressing the Esc key or the Cancel button of an InstallScript dialog box. NOTE • The abort statement exits the installation and runs the uninstaller in silent mode to clean up the aborted installation. The exit statement aborts the installation, but does not remove anything from the target system. • The abort statement does not call a rollback if initiated after the OnFirstUIAfter event. BOOL Boolean data: either TRUE (1) or FALSE (0). Variables of this type should not be used to store any other values. Like C++, InstallScript evaluates non-zero values as TRUE; only the value of zero is evaluated as FALSE. Normally, the value of one is used to indicate TRUE.
84page
Chapter 3: Language Keywords cdecl 22 InstallShield InstallScript Language Reference Guide cdecl P ROJECT This information applies to InstallScript projects. The cdecl keyword is used when declaring an external DLL function that uses the cdecl calling convention. For example: prototype cdecl POINTER Msvcrt.memcpy( byref string, pointer, long ); In previous versions of InstallShield Professional, the setup engine always used the stdcall convention but would sometimes overlook an inconsistent DLL convention. Most Windows API functions use the stdcall (WINAPI) calling convention. Consult Microsoft documentation for more information about calling conventions. exit When the setup program encounters an exit statement in the script it is executing, the setup process terminates. Each setup script contains—at most—one exit statement. If your script includes conditional expressions that might cause it to exit before the installation has completed, you should use abort instead of exit. export The prototype of any function that is called directly by the setup engine must be marked as export. An example is shown below: export prototype NewFeature1_Installing(); external The keyword external is reserved and may not be used. for...endfor The for statement is designed to execute one or more statements a fixed number of times. It begins with the keyword for and an expression that specifies the number of times statements within the for structure are to be executed. The for structure ends with the keyword endfor. NOTE The for statement itself is not terminated with a semicolon; however, a semicolon is required after the endfor statement.
85page
Chapter 3: Language Keywords goto InstallShield InstallScript Language Reference Guide 23 Using for...endfor In the following example, the function MessageBox is called 10 times. On the first pass, iCount is set to 1. Because 1 is in the specified range (1 to 10), the message box is displayed. Then iCount is incremented by 1 and the for statement is resolved again. This time, iCount = 2 (still in the specified range) and the message box is displayed a second time. When iCount is incremented after the tenth pass, its value becomes 11. Because this value is outside the specified range, the for statement ends. for iCount = 1 to 10 MessageBox ("This appears ten times.", INFORMATION); endfor; Adjusting the Increment The default increment in a for statement is one (1), but you can use the keyword step to adjust the increment. In the example below, step increases the value of iCount by 10 each time loop is executed. On the first pass, iCount = 10; on the second pass, iCount = 20; on the third pass, iCount = 30, and so on. for iCount = 10 to 100 step 10 MessageBox ("This appears ten times.", INFORMATION); endfor; Counting Down from a Higher Number to a Lower Number You can count down from a higher number to a lower number by using the keyword downto in place of the keyword to. In the following example, a message box is displayed three times. The first time the loop is entered, j is set to 20. Because downto specifies that the controlling variable be decremented and step 5 sets a decrement of 5 per loop, j is equal to 15 the second time the loop is entered. The third time, j is equal to 10. for j = 20 downto 10 step 5 MessageBox ("This appears three times.", INFORMATION); endfor; NOTE You cannot define a label inside a for statement. goto The goto keyword is used to branch directly to the statement immediately following a specified label. In the following code fragment, the goto statement causes execution to continue with the AskText statement.
86page
Chapter 3: Language Keywords if 24 InstallShield InstallScript Language Reference Guide Name: AskText("Company name:", "", szSrc); if (szSrc = "") then MessageBox("Please enter the company name.", SEVERE); goto Name; endif; A goto statement in the main program must specify a label that has been declared in the main program. A goto statement in a function must specify a label that has been declared in that function. if Use an if statement when you want your script to choose between two or more options. An if statement consists of the keyword if, a condition to be evaluated, the keyword then, and the keyword endif followed by a semicolon, as shown below: if (condition) then // statements to be executed if condition is true endif; The condition can be one of the following: • A Boolean or integer constant, variable or literal. • An expression that produces a Boolean or integer result. • A function that returns an integer result. The parentheses around the condition are optional, but highly recommended for readability. TIP Many InstallScript functions return a negative value when they fail. When using the result of InstallScript functions as the condition in an if statement, test for failure by using a statement like the one below: if (FunctionA (ParameterOne) < 0) then // Statements to handle the failure else // Statements when the function succeeds endif; InstallScript provides the following if statement structures: • if Structure with goto • if-then Structure • if-then-else Structure • Nested if-then-else Structure
87page
Chapter 3: Language Keywords if InstallShield InstallScript Language Reference Guide 25 • elseif Structure if Structure with goto InstallScript supports a special form of the if statement that can be used only with goto statements: if condition goto labelname; This special structure is has the following features: • The condition must be followed by a goto statement. • The keyword then is not used. • The keyword endif is not used. In the following example, the user will be prompted to enter a company name as long as szSrc is a null string (“”). Name: AskText("Company name:", "", szSrc); if (szSrc = "") goto Name; if-then Structure The simplest if statement evaluates an expression and performs a specified action if the expression is true. If the expression is not true, InstallShield ignores the entire statement. For example: if (szStringA = "exit") then AskYesNo ( "Are you sure you want to exit?", NO ); endif; If szStringA equals "exit", the test evaluates to TRUE (1) and the AskYesNo function is called. If szStringA contains anything else, the result is FALSE (0) and the entire statement is ignored. The sample code below compares the values of the variable nDialog and the constant DLG _ ERR. If they are equivalent, InstallShield executes the MessageBox function: if (nDialog = DLG_ERR) then MessageBox ("Error has occurred", WARNING); endif; TIP You may find that your if statement is easier to read when you place the expression to be evaluated in parentheses, but the parentheses are optional in InstallScript.
88page
Chapter 3: Language Keywords if 26 InstallShield InstallScript Language Reference Guide if-then-else Structure An if statement can also specify one or more statements to be executed if the condition is false. This option is indicated with the keyword else, as shown below: if (condition) then // statements to be executed if condition is true else // statements to be executed if condition is false endif; In the example below, if szStringA equals "exit," the test evaluates to TRUE (1), and the AskYesNo function is called. If szStringA is not equal to "exit," the result is FALSE (0), and the MessageBox function is called following the else statement. if szStringA = "exit" then AskYesNo ("Are you sure you want to exit?", NO ); else MessageBox ("Please wait... ", INFORMATION ); endif; Nested if-then-else Structure You can create nested if statements, in which one if statement is embedded in another: if (first condition) then if (second condition) then // statements to be executed if first and // second conditions are true else // statements to be executed if first is true but // second condition is false endif; else if (third condition) then // statements to be executed if first condition is // false and third condition is true else // statements to be executed if first condition is // false and third condition is false endif; endif; In the following example, if the value of szStringA is "exit", AskYesNo is called. If the value of szStringA is "exit", the program displays a message box. if szStringA is not equal to either of those values, the execution proceeds to the label UserErrorHandler.
89page
Chapter 3: Language Keywords if InstallShield InstallScript Language Reference Guide 27 if szStringA = "exit" then AskYesNo ("Are you sure you want to exit?", NO); else if szStringA = "continue" then MessageBox ("Please wait...", INFORMATION); else UserErrorHandler; endif; endif; elseif Structure InstallScript provides the elseif statement to create if structures in which the else branch of one if statement leads to another if statement: if (first condition) then // statements to be executed if first condition // is true elseif (second condition) then // statements to be executed if first condition // is false and second condition is true elseif (third condition) then // statements to be executed if first and second // conditions are false and third condition is // true endif; In the following example, if szStringA equals “exit,” AskYesNo is called. If szStringA is not equal to “exit,” the program continues to the elseif statement to test if szStringA is equal to “continue.” If szStringA is equal to “continue,” the result is TRUE and MessageBox is called. If szStringA is not equal to “continue,” the program moves to the next elseif, and so on. if szStringA = "exit" then AskYesNo ("Are you sure you want to exit?", NO ); elseif szStringA = "continue" then MessageBox ("Please wait...", INFORMATION ); elseif szStringA = "reboot" then goto StartHere; endif; N OTE You cannot define a label inside an if statement.
90page
Chapter 3: Language Keywords method 28 InstallShield InstallScript Language Reference Guide method P ROJECT This information applies to InstallScript projects. The method keyword is used to declare a method in an object script with the following syntax: method <return variable type> <method name> ( <argument variable type(s)> ); For example: method STRING MyMethod ( STRING, NUMBER ); If you add a method to the object project by using the Add New Method dialog box, a method declaration is automatically placed in the object script. property() PROJECT This information applies to InstallScript projects. The property() keyword is used to declare a property and its get and/or put procedures in an object script with the following syntax: For example: property(get,put) STRING MyProperty ( NUMBER ); Table 3-1: Property() Keyword Declarations Access Declaration Read only property(get) <return variable type> <property name> ( <argument variable type(s)> ); Write only property(put) <return variable type> <property name> ( <argument variable type(s)> ); Read/write property(get,put) <return variable type> <property name> ( <argument variable type(s)> );
91page
Chapter 3: Language Keywords repeat...until InstallShield InstallScript Language Reference Guide 29 If you add a property to the object project by using the Add New Property dialog box, a property declaration is automatically placed in the object script. repeat...until The repeat statement is analogous to the do...while loop in the C language. It also is very similar to the InstallScript while statement. There are two main differences between repeat and while in InstallScript: • The repeat statement must loop at least once. A while statement might not loop at all. • A while statement terminates when the expression evaluates as false. A repeat statement terminates when the expression evaluates as true. TASK To create a repeat loop: 1. Set the variable you will be using in the conditional test as you would for a while loop. 2. Type repeat on its own line with no punctuation. 3. Build the operation(s) that you want repeated. 4. Add the operation that changes the test variable (for example, nCount = nCount + 1, or nCount = SomeVariable). 5. End the loop with an until statement containing the conditional test in parentheses. The following example demonstrates repeat loop syntax: nCount = 1; repeat MessageBox("Count is less than 5", INFORMATION); nCount = nCount + 1; until (nCount = 5); NOTE You cannot define a label inside of the repeat statement. return You can use the return statement to return a value from a user-defined function (if the function prototype does not specify a return type of void). When a return statement is encountered, program flow returns to the point at which the function was called.
92page
Chapter 3: Language Keywords set 30 InstallShield InstallScript Language Reference Guide When used to return from a call to a user-defined function, the return statement can return a specified value to the caller. The return value of most built-in functions will be either 0 (zero), indicating the success of the function, or a value less than zero (< 0), indicating failure. You can assign a number to the return value by using a return statement above the end statement in the function block, as shown below: return -1; end; This attribute allows you to return the value of a local variable to the caller, even though the local variable itself is destroyed: function MyFunction(ParamOne, ParamTwo) NUMBER nNumber; begin nNumber = (ParamOne + ParamTwo); // . . . return nNumber; end; set The set keyword must precede the assignment of an OBJECT variable to a reference returned by the CreateObject function. For example: function OnBegin( ) OBJECT oMSI; begin // create the object set oMSI = CreateObject("WindowsInstaller.Installer"); // use the object (display MSI version on user's system) MessageBox("Your MSI version is: " + oMSI.Version, INFORMATION); // free the object set oMSI = NOTHING; end; NOTE You can use the keywords try–catch–endcatch for more control over exception handling for COM objects.
93page
Chapter 3: Language Keywords stdcall InstallShield InstallScript Language Reference Guide 31 stdcall P ROJECT This information applies to InstallScript projects.The stdcall keyword is used when declaring an external DLL function that uses the stdcall calling convention. For example: prototype stdcall POINTER kernel32.lstrcpy( byref string, byref string); If no calling convention is specified, stdcall is assumed. Most Windows API functions use the stdcall (WINAPI) calling convention. Consult Microsoft documentation for more information about calling conventions. switch...endswitch The switch statement is similar to the elseif Structure statement. Use the switch statement to execute one of several different sections of code, depending on the value of an expression. The switch statement evaluates the expression and then branches to the case statement whose constant value matches the result of the expression. If no match is found among the case statements, control passes to a default statement, if one has been specified. Creating Switch Statements TASK To create a switch statement: 1. Type the keyword switch, followed by the expression to be evaluated. The expression—which can be a constant, variable, arithmetic expression, logical expression, or function result—must be enclosed within parentheses. Do not punctuate this line. 2. For each option, type the keyword case and one or more constants followed by a colon. If more than one constant is specified, delimit them with commas. Note that only constants can be specified here. Specifying a variable name, string table reference, function result, or other type of expression after the keyword case results in an error. 3. For each case, follow the colon with the statement or statements to be executed for that option. Terminate each statement with a semicolon. 4. After all case statements have been specified, use the keyword default, followed by a colon (:), to control the program when the expression does not match any of the stated cases. 5. Close the block with the keyword endswitch, followed by a semicolon (;).
94page
Chapter 3: Language Keywords try, catch, and endcatch 32 InstallShield InstallScript Language Reference Guide Example Script The following script segment displays the current video resolution of the computer on which it is executed: STRING szMsg, svResult; NUMBER nvResult; GetSystemInfo (VIDEO, nvResult, svResult); switch (nvResult) case IS_UNKNOWN: szMsg = "The user's video is unknown."; case IS_EGA: szMsg = "EGA resolution."; case IS_VGA: szMsg = "VGA resolution."; case IS_SVGA: szMsg = "Super VGA (800 x 600) resolution."; case IS_XVGA: szMsg = "XVGA (1024 x 768) resolution."; case IS_UVGA: szMsg = "Greater than 1024 x 768 resolution."; default: szMsg = "Error"; endswitch; MessageBox (szMsg, INFORMATION); NOTE Only one case block is executed each time a switch statement is executed. After InstallShield executes a case block, it executes the next statement after the endswitch. A switch block can be quite useful inside of a while loop. By using the case statements as flags, you can create a loop with optional exit points. try, catch, and endcatch PROJECT This information applies to InstallScript projects. The keywords try, catch, and endcatch are used for exception handling. For more information on exception handling, see Exception Handling.
95page
Chapter 3: Language Keywords void InstallShield InstallScript Language Reference Guide 33 void Void is not a true data type, in the sense that a variable cannot be declared as type void. Void is only used in function prototypes to indicate that the function does not return a value, as in the following: prototype void Subroutine(int); function void Subroutine(int); begin // perform operations, but // do not return a value end; while...endwhile Use the while statement when you want to execute one or more statements repeatedly, as long as a particular condition is true. If the condition is not true when the statement is first executed, the loop is not performed. TASK To create a while loop: 1. Set the variable you are using as the condition to an initial state. 2. Type the keyword while, followed by the conditional test in parentheses. Do not punctuate this line. 3. Build the operation(s) that you want repeated. 4. Add the operation that changes the test variable (for example, nCount = nCount + 1, or nCount = SomeVariable). 5. End the loop by typing endwhile, followed by a semicolon. In the following example, the message box is displayed four times. nCount = 1; while (nCount < 5) MessageBox ("This is still true.", INFORMATION); nCount = nCount + 1; endwhile; Because nCount is assigned an initial value of 1, the while statement evaluates TRUE the first time it is executed; the message box is displayed and nCount is incremented by 1. After the fourth pass through the loop, nCount is equal to 5; the while statement evaluates FALSE and the program continues executing with the statement after endwhile.
96page
Chapter 3: Language Keywords while...endwhile 34 InstallShield InstallScript Language Reference Guide You cannot define a label within a while block. You can, however, nest while statements in InstallScript. You must end each while block with endwhile. Nested while Example NOTE To call this function in a Basic MSI setup, you must first create a custom action for the entry- point function, execute the custom action in a sequence or as the result of a dialog's control event, and then build the release. /* This script illustrates a nested while loop. * It searches for the specified type of files and * shows the number of lines in each file. */ #define SOURCEDIR "c:\\example"; // Include Ifx.h for built-in InstallScript function prototypes. #include "Ifx.h" export prototype ExFn_Nested while(HWND); function ExFn_Nested while(hMSI) LIST listID; STRING svTarget, svResult, filename, svLine, szPath, szFileName; NUMBER nResult, nOp,nFileHandle,count; begin count = 0; nOp = RESET; svTarget = SOURCEDIR; listID = ListCreate (STRINGLIST); while FindAllFiles (svTarget, "*.txt", svResult, nOp) = 0; // To get the name of the file in the fully specified path StrGetTokens(listID,svResult,"\\"); ListCurrentString(listID,filename); // Set the file mode to normal. OpenFileMode(FILE_MODE_NORMAL); szFileName = filename; szPath = svTarget; // The following opens the file for editing. OpenFile(nFileHandle, szPath, szFileName);
97page
Chapter 3: Language Keywords Flow Control InstallShield InstallScript Language Reference Guide 35 /*------------------------------------------------------------------*\ * * The following retrieves each line of text from the open file and increments * a count to find the number of lines. * \*------------------------------------------------------------------*/ while (GetLine (nFileHandle, svLine) = 0) count = count + 1; endwhile; SprintfBox(INFORMATION,"The Total lines in the file", "The No. of lines in the file %s is %d",filename,count); count = 0; // The following closes the file CloseFile(nFileHandle); // Continue searching files where last file was left off nOp = CONTINUE; if (FindAllFiles (svTarget, "*.txt", svResult, nOp) < 0) then abort; endif; endwhile; end; Flow Control Like most programming languages, InstallScript processes statements within a function block sequentially, starting with the first statement and ending with the last. The linear flow of execution within a function block can be controlled with conditional statements that perform branching and iteration. Branching is most commonly performed with an if statement that directs execution down one path or another. Iteration is performed with loop statements that execute one or more statements repeatedly, either for a set number of times or as long as a specified condition is met. To control the flow of execution within scripts, InstallShield provides the following keywords:
98page
Chapter 3: Language Keywords Flow Control 36 InstallShield InstallScript Language Reference Guide • abort • exit • for..endfor • goto • if..then..else..endif • repeat..until • return • switch..endswitch • while..endwhile
99page
InstallShield InstallScript Language Reference Guide 37 4 PREDEFINED CONSTANTS A predefined constant is an identifier reserved by InstallScript to represent a specific literal value. InstallScript uses predefined constants to represent certain data values that are passed to and returned by built-in functions. By using these predefined constants rather than literal values, you can improve the readability of your setup scripts. You cannot change the value InstallShield assigns to a predefined constant. However, you can determine the value of a predefined constant by calling SprintfBox, as shown in the example below, which displays the value of the predefined constant FEATURE _ FIELD _ SELECTED: SprintfBox (INFORMATION, "", "%d", FEATURE_FIELD_SELECTED); Although you can use a literal value in place of a predefined constant, Macrovision strongly recommends that you use predefined constants wherever indicated for a function. Following is a list of the predefined constants used by InstallScript. AFTER AFTER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • EzBatchAddString • EzBatchAddPath
100page
Chapter 4: Predefined Constants ALLCONTENTS 38 InstallShield InstallScript Language Reference Guide • ConfigAdd • ConfigMove • ListAddItem • ListAddString • PathAdd • PathMove • BatchAdd • PathMove • BatchMoveEx • FileInsertLine • EzConfigAddDriver • EzConfigAddString ALLCONTENTS ALLCONTENTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DeleteDir ALLCONTROLS ALLCONTROLS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlSetFont APPEND APPEND is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
101page
Chapter 4: Predefined Constants ASKDESTPATH InstallShield InstallScript Language Reference Guide 39 Used With • FileInsertLine ASKDESTPATH ASKDESTPATH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • AskDestPath ASKOPTIONS ASKOPTIONS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • AskOptions • PlaceWindow ASKPATH ASKPATH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • AskPath • PlaceWindow ASKTEXT ASKTEXT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
102page
Chapter 4: Predefined Constants BACK 40 InstallShield InstallScript Language Reference Guide Used With • AskText • PlaceWindow BACK BACK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SdWelcome • FeatureDialog • AskOptions • AskText • AskPath • SdBitmap • SdAskOptions • SdLicense • SdAskOptionsList • SdSelectFolder • SdFeatureDialog • SdStartCopy • SdFeatureDialogAdv • AskDestPath • SdFeatureMult • SdSetupType • SetupType • SdAskDestPath • SdFeatureDialog2 • SdRegisterUserEx • SdShowInfoList • Welcome • SelectFolder • SdDisplayTopics • SdOptionsButtons
103page
Chapter 4: Predefined Constants BACKBUTTON InstallShield InstallScript Language Reference Guide 41 • SdRegisterUser • SdShowAnyDialog • SdShowDlgEdit1 • SdShowDlgEdit2 • SdShowDlgEdit3 • SdShowFileMods BACKBUTTON BACKBUTTON is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Disable • Enable • Is BACKGROUND BACKGROUND is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlaceWindow • SetColor • Enable • SizeWindow • Disable BACKGROUNDCAPTION BACKGROUNDCAPTION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
104page
Chapter 4: Predefined Constants BASEMEMORY 42 InstallShield InstallScript Language Reference Guide Used With • SetTitle BASEMEMORY PROJECT This information applies to InstallScript projects. BASEMEMORY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo BEFORE BEFORE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PathMove • FileInsertLine • EzBatchAddPath • EzBatchAddString • BatchAdd • BatchMoveEx • EzConfigAddDriver • EzConfigAddString • ConfigAdd • ConfigMove • ListAddItem • ListAddString • PathAdd
105page
Chapter 4: Predefined Constants BIF _ BROWSEFORCOMPUTER InstallShield InstallScript Language Reference Guide 43 BIF _ BROWSEFORCOMPUTER P ROJECT This information applies to InstallScript projects. BIF _ BROWSEFORCOMPUTER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDirEx BIF _ BROWSEFORPRINTER PROJECT This information applies to InstallScript projects. BIF _ BROWSEFORPRINTER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDirEx BIF _ DONTGOBELOWDOMAIN PROJECT This information applies to InstallScript projects. BIF _ DONTGOBELOWDOMAIN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDirEx
106page
Chapter 4: Predefined Constants BIF _ EDITBOX 44 InstallShield InstallScript Language Reference Guide BIF _ EDITBOX P ROJECT This information applies to InstallScript projects. BIF _ EDITBOX is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDirEx BIF _ RETURNFSANCESTORS PROJECT This information applies to InstallScript projects. BIF _ RETURNFSANCESTORS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDirEx BIF _ RETURNONLYFSDIRS PROJECT This information applies to InstallScript projects. BIF _ RETURNONLYFSDIRS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDirEx
107page
Chapter 4: Predefined Constants BIF _ STATUSTEXT InstallShield InstallScript Language Reference Guide 45 BIF _ STATUSTEXT P ROJECT This information applies to InstallScript projects. BIF _ STATUSTEXT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDirEx BILLBOARD BILLBOARD is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Disable • PlaceWindow BITMAPICON BITMAPICON is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlaceBitmap BK _ BLUE BK _ BLUE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor
108page
Chapter 4: Predefined Constants BK _ GREEN 46 InstallShield InstallScript Language Reference Guide BK _ GREEN BK _ GREEN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ MAGENTA BK _ MAGENTA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ ORANGE BK _ ORANGE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ PINK BK _ PINK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor
109page
Chapter 4: Predefined Constants BK _ RED InstallShield InstallScript Language Reference Guide 47 BK _ RED BK _ RED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ SMOOTH BK _ SMOOTH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ SOLIDBLACK BK _ SOLIDBLACK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ SOLIDBLUE BK _ SOLIDBLUE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor
110page
Chapter 4: Predefined Constants BK _ SOLIDGREEN 48 InstallShield InstallScript Language Reference Guide BK _ SOLIDGREEN BK _ SOLIDGREEN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ SOLIDMAGENTA BK _ SOLIDMAGENTA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ SOLIDORANGE BK _ SOLIDORANGE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ SOLIDPINK BK _ SOLIDPINK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor
111page
Chapter 4: Predefined Constants BK _ SOLIDRED InstallShield InstallScript Language Reference Guide 49 BK _ SOLIDRED BK _ SOLIDRED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ SOLIDWHITE BK _ SOLIDWHITE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ SOLIDYELLOW BK _ SOLIDYELLOW is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor BK _ YELLOW BK _ YELLOW is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor
112page
Chapter 4: Predefined Constants BLACK 50 InstallShield InstallScript Language Reference Guide BLACK BLACK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetTitle BLUE BLUE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor • SetTitle BOOTUPDRIVE BOOTUPDRIVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo BUTTON _ CHECKED BUTTON _ CHECKED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlSetState • CtrlGetState
113page
Chapter 4: Predefined Constants BUTTON _ UNCHECKED InstallShield InstallScript Language Reference Guide 51 BUTTON _ UNCHECKED BUTTON _ UNCHECKED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlSetState • CtrlGetState BYTES BYTES is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ConvertSizeToUnits CANCEL CANCEL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDir CANCELBUTTON CANCELBUTTON is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Disable • Enable • Is
114page
Chapter 4: Predefined Constants CDROM 52 InstallShield InstallScript Language Reference Guide CDROM CDROM is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo CDROM _ DRIVE CDROM _ DRIVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetValidDrivesList CENTERED CENTERED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlaceWindow • PlaceBitmap CHECKBOX CHECKBOX is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DialogSetInfo
115page
Chapter 4: Predefined Constants CHECKBOX95 InstallShield InstallScript Language Reference Guide 53 CHECKBOX95 CHECKBOX95 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DialogSetInfo CHECKLINE CHECKLINE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DialogSetInfo CHECKMARK CHECKMARK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DialogSetInfo COLORS COLORS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo
116page
Chapter 4: Predefined Constants COMMAND 54 InstallShield InstallScript Language Reference Guide COMMAND COMMAND is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • BatchMoveEx • ConfigFind • EzBatchAddString • BatchAdd • BatchDeleteEx COMMON COMMON is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ProgDefGroupType COMPACT COMPACT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetupType • SdSetupType COMPARE _ DATE COMPARE _ DATE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
117page
Chapter 4: Predefined Constants COMPARE _ MD5 _ SIGNATURE InstallShield InstallScript Language Reference Guide 55 Used With • FileCompare COMPARE _ MD5 _ SIGNATURE COMPARE _ MD5 _ SIGNATURE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileCompare COMPARE _ SIZE COMPARE _ SIZE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileCompare COMPARE _ VERSION COMPARE _ VERSION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileCompare COMP _ NORMAL COMP _ NORMAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • XCopyFile
118page
Chapter 4: Predefined Constants COMP _ UPDATE _ DATE 56 InstallShield InstallScript Language Reference Guide COMP _ UPDATE _ DATE COMP _ UPDATE _ DATE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • XCopyFile COMP _ UPDATE _ SAME COMP _ UPDATE _ SAME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • XCopyFile COMP _ UPDATE _ VERSION COMP _ UPDATE _ VERSION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • XCopyFile CONTINUE CONTINUE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileGrep • BatchFind • FindFile • ConfigFind • PathFind
119page
Chapter 4: Predefined Constants COPY _ ERR _ CREATEDIR InstallShield InstallScript Language Reference Guide 57 COPY _ ERR _ CREATEDIR COPY _ ERR _ CREATEDIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CopyFile • XCopyFile COPY _ ERR _ MEMORY COPY _ ERR _ MEMORY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CopyFile • XCopyFile COPY _ ERR _ NODISKSPACE COPY _ ERR _ NODISKSPACE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CopyFile • XCopyFile COPY _ ERR _ OPENINPUT COPY _ ERR _ OPENINPUT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CopyFile • XCopyFile
120page
Chapter 4: Predefined Constants COPY _ ERR _ OPENOUTPUT 58 InstallShield InstallScript Language Reference Guide COPY _ ERR _ OPENOUTPUT COPY _ ERR _ OPENOUTPUT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CopyFile • XCopyFile COPY _ ERR _ TARGETREADONLY COPY _ ERR _ TARGETREADONLY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CopyFile • XCopyFile CPU CPU is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo CURRENTROOTKEY CURRENTROOTKEY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • VarRestore • VarSave
121page
Chapter 4: Predefined Constants CUSTOM InstallShield InstallScript Language Reference Guide 59 CUSTOM CUSTOM is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetupType • SdSetupType DATA _ COMPONENT DATA _ COMPONENT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SilentReadData • SilentWriteData DATA _ LIST DATA _ LIST is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SilentWriteData DATA _ NUMBER DATA _ NUMBER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SilentReadData • SilentWriteData
122page
Chapter 4: Predefined Constants DATA _ STRING 60 InstallShield InstallScript Language Reference Guide DATA _ STRING DATA _ STRING is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SilentReadData • SilentWriteData DATE DATE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo DEFAULT DEFAULT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • switch...endswitch DEFWINDOWMODE DEFWINDOWMODE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Enable
123page
Chapter 4: Predefined Constants DELETE InstallShield InstallScript Language Reference Guide 61 DELETE P ROJECT This information applies to InstallScript projects. DELETE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • SERVICE _ IS _ PARAMS DELETE _ EOF DELETE _ EOF is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileDeleteLine DIALOGCACHE DIALOGCACHE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Disable • Enable DIFXAPI _ ERROR DIFXAPI _ ERROR is a predefined constant used to represent a value that is available for use with one or event handlers. You cannot change the value of a predefined constant. Used With • OnDIFxLogCallback
124page
Chapter 4: Predefined Constants DIFXAPI _ INFO 62 InstallShield InstallScript Language Reference Guide DIFXAPI _ INFO DIFXAPI _ INFO is a predefined constant used to represent a value that is available for use with one or more event handlers. You cannot change the value of a predefined constant. Used With • OnDIFxLogCallback DIFXAPI _ SUCCESS DIFXAPI _ SUCCESS is a predefined constant used to represent a value that is available for use with one or more event handlers. You cannot change the value of a predefined constant. Used With • OnDIFxLogCallback DIFXAPI _ WARNING DIFXAPI _ WARNING is a predefined constant used to represent a value that is available for use with one or more event handlers. You cannot change the value of a predefined constant. Used With • OnDIFxLogCallback DIRECTORY DIRECTORY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ParsePath
125page
Chapter 4: Predefined Constants DIR _ WRITEABLE InstallShield InstallScript Language Reference Guide 63 DIR _ WRITEABLE DIR _ WRITEABLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is DISABLE DISABLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Disable DISABLE _ ALLUSERBTN PROJECT This information applies to InstallScript projects. DISABLE _ ALLUSERBTN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SdCustomerInformation • SdCustomerInformationEx DISABLE _ PERUSERBTN PROJECT This information applies to InstallScript projects. DISABLE _ PERUSERBTN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
126page
Chapter 4: Predefined Constants DISK 64 InstallShield InstallScript Language Reference Guide Used With • SdCustomerInformation • SdCustomerInformationEx DISK DISK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ParsePath DISK1FEATURE PROJECT This information applies to InstallScript projects. DISK1FEATURE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. DISK1FEATURE specifies the feature with the files needed for maintenance setups and uninstallation. (Note that this feature is automatically placed in your .cab files by the media builder and is not displayed in the IDE.) Used With • FeatureSelectItem • FeatureIsItemSelected DISK _ INFO _QUERY_ALL DISK _ INFO _QUERY_ALL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo
127page
Chapter 4: Predefined Constants DISK _ INFO _QUERY_BYTES_PER_CLUSTER InstallShield InstallScript Language Reference Guide 65 DISK _ INFO _QUERY_BYTES_PER_CLUSTER DISK _ INFO _QUERY_BYTES_PER_CLUSTER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo DISK _ INFO _QUERY_DISK_FREE_SPACE DISK _ INFO _QUERY_DISK_FREE_SPACE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo DISK _ INFO _QUERY_DISK_TOTAL_SPACE DISK _ INFO _QUERY_DISK_TOTAL_SPACE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo DISK _ INFO _QUERY_DRIVE_TYPE DISK _ INFO _QUERY_DRIVE_TYPE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo
128page
Chapter 4: Predefined Constants DISK _ TOTALSPACE 66 InstallShield InstallScript Language Reference Guide DISK _ TOTALSPACE DISK _ TOTALSPACE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo DISK _ TOTALSPACE _ EX DISK _ TOTALSPACE _ EX is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo DLG _ ASK _ OPTIONS DLG _ ASK _ OPTIONS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle DLG _ ASK _ PATH DLG _ ASK _ PATH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle
129page
Chapter 4: Predefined Constants DLG _ ASK _ TEXT InstallShield InstallScript Language Reference Guide 67 DLG _ ASK _ TEXT DLG _ ASK _ TEXT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle DLG _ ASK _ YESNO DLG _ ASK _ YESNO is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle DLG _ CENTERED DLG _ CENTERED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DefineDialog DLG _ CLOSE DLG _ CLOSE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • WaitOnDialog
130page
Chapter 4: Predefined Constants DLG _ DIR _ DIRECTORY 68 InstallShield InstallScript Language Reference Guide DLG _ DIR _ DIRECTORY DLG _ DIR _ DIRECTORY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlDir DLG _ DIR _ DRIVE DLG _ DIR _ DRIVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlDir DLG _ DIR _ FILE DLG _ DIR _ FILE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlDir DLG _ ENTER _ DISK DLG _ ENTER _ DISK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle
131page
Chapter 4: Predefined Constants DLG _ ERR InstallShield InstallScript Language Reference Guide 69 DLG _ ERR DLG _ ERR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • WaitOnDialog • EzDefineDialog • ReleaseDialog • CtrlGetState • DefineDialog DLG _ ERR _ ALREADY _ EXISTS DLG _ ERR _ ALREADY _ EXISTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DefineDialog • EzDefineDialog DLG _ ERR _ ENDDLG DLG _ ERR _ ENDDLG is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ReleaseDialog DLG _ INFO _ ALTIMAGE DLG _ INFO _ ALTIMAGE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
132page
Chapter 4: Predefined Constants DLG _ INFO _ CHECKSELECTION 70 InstallShield InstallScript Language Reference Guide Used With • DialogSetInfo DLG _ INFO _ CHECKSELECTION DLG _ INFO _ CHECKSELECTION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DialogSetInfo DLG _ INFO _ KUNITS DLG _ INFO _ KUNITS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DialogSetInfo DLG _ INFO _ USEDECIMAL DLG _ INFO _ USEDECIMAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DialogSetInfo DLG _ INIT DLG _ INIT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • WaitOnDialog
133page
Chapter 4: Predefined Constants DLG _ MSG _ ALL InstallShield InstallScript Language Reference Guide 71 DLG _ MSG _ ALL DLG _ MSG _ ALL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DefineDialog DLG _ MSG _ INFORMATION DLG _ MSG _ INFORMATION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle DLG _ MSG _ SEVERE DLG _ MSG _ SEVERE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle DLG _ MSG _ STANDARD DLG _ MSG _ STANDARD is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DefineDialog
134page
Chapter 4: Predefined Constants DLG _ MSG _ WARNING 72 InstallShield InstallScript Language Reference Guide DLG _ MSG _ WARNING DLG _ MSG _ WARNING is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle DLG _ STATUS DLG _ STATUS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle DLG _ USER _ CAPTION DLG _ USER _ CAPTION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDialogTitle DOINSTALL _ OPTION _ NOHIDEPROGRESS DOINSTALL _ OPTION _ NOHIDEPROGRESS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall
135page
Chapter 4: Predefined Constants DOINSTALL _ OPTION _ NOHIDESPLASH InstallShield InstallScript Language Reference Guide 73 DOINSTALL _ OPTION _ NOHIDESPLASH DOINSTALL _ OPTION _ NOHIDESPLASH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall DOINSTALL _ OPTION _ NOLANGSWITCH DOINSTALL _ OPTION _ NOLANGSWITCH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall DOINSTALL _ OPTION _ NOSETBATCHINSTALL DOINSTALL _ OPTION _ NOSETBATCHINSTALL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall DOTNETFRAMEWORKINSTALLED DOTNETFRAMEWORKINSTALLED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is
136page
Chapter 4: Predefined Constants DRIVE 74 InstallShield InstallScript Language Reference Guide DRIVE DRIVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo DRIVE _ CDROM DRIVE _ CDROM is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo DRIVE _ FIXED DRIVE _ FIXED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo DRIVE _ NO _ ROOT _ DIR DRIVE _ NO _ ROOT _ DIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo
137page
Chapter 4: Predefined Constants DRIVE _ RAMDISK InstallShield InstallScript Language Reference Guide 75 DRIVE _ RAMDISK DRIVE _ RAMDISK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo DRIVE _ REMOTE DRIVE _ REMOTE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo DRIVE _ REMOVABLE DRIVE _ REMOVABLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo DRIVE _ UNKNOWN DRIVE _ UNKNOWN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetDiskInfo
138page
Chapter 4: Predefined Constants DRIVER _ PACKAGE _ DELETE _ FILES 76 InstallShield InstallScript Language Reference Guide DRIVER _ PACKAGE _ DELETE _ FILES DRIVER _ PACKAGE _ DELETE _ FILES is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageUninstall DRIVER _ PACKAGE _ FORCE DRIVER _ PACKAGE _ FORCE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageInstall • DIFxDriverPackagePreinstall • DIFxDriverPackageUninstall DRIVER _ PACKAGE _ LEGACY _ MODE DRIVER _ PACKAGE _ LEGACY _ MODE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageInstall • DIFxDriverPackagePreinstall DRIVER _ PACKAGE _ ONLY _ IF _ DEVICE _ PRESENT DRIVER _ PACKAGE _ ONLY _ IF _ DEVICE _ PRESENT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageInstall • DIFxDriverPackagePreinstall
139page
Chapter 4: Predefined Constants DRIVER _ PACKAGE _ REPAIR InstallShield InstallScript Language Reference Guide 77 DRIVER _ PACKAGE _ REPAIR DRIVER _ PACKAGE _ REPAIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageInstall • DIFxDriverPackagePreinstall • DIFxDriverPackageUninstall DRIVER _ PACKAGE _ SILENT DRIVER _ PACKAGE _ SILENT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageInstall • DIFxDriverPackagePreinstall EDITBOX _ CHANGE EDITBOX _ CHANGE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlGetSubCommand EFF _ BOXSTRIPE EFF _ BOXSTRIPE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDisplayEffect
140page
Chapter 4: Predefined Constants EFF _ FADE 78 InstallShield InstallScript Language Reference Guide EFF _ FADE EFF _ FADE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDisplayEffect EFF _ HORZREVEAL EFF _ HORZREVEAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDisplayEffect EFF _ HORZSTRIPE EFF _ HORZSTRIPE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDisplayEffect EFF _ NONE EFF _ NONE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDisplayEffect
141page
Chapter 4: Predefined Constants EFF _ REVEAL InstallShield InstallScript Language Reference Guide 79 EFF _ REVEAL EFF _ REVEAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDisplayEffect EFF _ VERTSTRIPE EFF _ VERTSTRIPE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetDisplayEffect ENABLE ENABLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Enable END _ OF _ FILE END _ OF _ FILE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileGrep
142page
Chapter 4: Predefined Constants END _ OF _ LIST 80 InstallShield InstallScript Language Reference Guide END _ OF _ LIST END _ OF _ LIST is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ListCurrentItem • ListCurrentString • ListGetFirstItem • ListSetIndex • ListDeleteItem • ListDeleteString • ListFindItem • ListFindString • ListCurrentString • ListGetNextItem • ListGetNextString • ListSetCurrentItem • ListSetCurrentString ENTERDISK ENTERDISK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • EnterDisk • PlaceWindow EQUALS EQUALS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
143page
Chapter 4: Predefined Constants ERROR _ ACCESS _ DENIED InstallShield InstallScript Language Reference Guide 81 Used With • VerCompare • FileCompare ERROR _ ACCESS _ DENIED PROJECT This information applies to InstallScript projects. ERROR _ ACCESS _ DENIED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ CIRCULAR _ DEPENDENCY PROJECT This information applies to InstallScript projects. ERROR _ CIRCULAR _ DEPENDENCY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ DATABASE _ DOES _ NOT _ EXIST PROJECT This information applies to InstallScript projects. ERROR _ DATABASE _ DOES _ NOT _ EXIST is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
144page
Chapter 4: Predefined Constants ERROR _ DEPENDENT _ SERVICES _ RUNNING 82 InstallShield InstallScript Language Reference Guide Used With • GetExtendedErrInfo ERROR _ DEPENDENT _ SERVICES _ RUNNING PROJECT This information applies to InstallScript projects. ERROR _ DEPENDENT _ SERVICES _ RUNNING is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ DUP _ NAME PROJECT This information applies to InstallScript projects. ERROR _ DUP _ NAME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ FILE _ NOT _ FOUND PROJECT This information applies to InstallScript projects. ERROR _ FILE _ NOT _ FOUND is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo
145page
Chapter 4: Predefined Constants ERROR _ INVALID _ HANDLE InstallShield InstallScript Language Reference Guide 83 ERROR _ INVALID _ HANDLE P ROJECT This information applies to InstallScript projects. ERROR _ INVALID _ HANDLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ INVALID _ PARAMETER PROJECT This information applies to InstallScript projects. ERROR _ INVALID _ PARAMETER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ INVALID _ SERVICE _ ACCOUNT PROJECT This information applies to InstallScript projects. ERROR _ INVALID _ SERVICE _ ACCOUNT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo
146page
Chapter 4: Predefined Constants ERROR _ INVALID _ SERVICE _ CONTROL 84 InstallShield InstallScript Language Reference Guide ERROR _ INVALID _ SERVICE _ CONTROL P ROJECT This information applies to InstallScript projects. ERROR _ INVALID _ SERVICE _ CONTROL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ PATH _ NOT _ FOUND PROJECT This information applies to InstallScript projects. ERROR _ PATH _ NOT _ FOUND is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ SERVICE _ ALREADY _ RUNNING PROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ ALREADY _ RUNNING is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo
147page
Chapter 4: Predefined Constants ERROR _ SERVICE _ CANNOT _ ACCEPT _ CTRL InstallShield InstallScript Language Reference Guide 85 ERROR _ SERVICE _ CANNOT _ ACCEPT _ CTRL P ROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ CANNOT _ ACCEPT _ CTRL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ SERVICE _ DATABASE _ LOCKED PROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ DATABASE _ LOCKED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ SERVICE _ DEPENDENCY _ DELETED PROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ DEPENDENCY _ DELETED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo
148page
Chapter 4: Predefined Constants ERROR _ SERVICE _ DEPENDENCY _ FAIL 86 InstallShield InstallScript Language Reference Guide ERROR _ SERVICE _ DEPENDENCY _ FAIL P ROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ DEPENDENCY _ FAIL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ SERVICE _ DISABLED PROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ DISABLED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ SERVICE _ DOES _ NOT _ EXIST PROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ DOES _ NOT _ EXIST is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo
149page
Chapter 4: Predefined Constants ERROR _ SERVICE _ EXISTS InstallShield InstallScript Language Reference Guide 87 ERROR _ SERVICE _ EXISTS P ROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ EXISTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ SERVICE _ LOGON _ FAILED PROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ LOGON _ FAILED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ SERVICE _ NOT _ ACTIVE PROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ NOT _ ACTIVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo
150page
Chapter 4: Predefined Constants ERROR _ SERVICE _ NO _ THREAD 88 InstallShield InstallScript Language Reference Guide ERROR _ SERVICE _ NO _ THREAD P ROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ NO _ THREAD is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ SERVICE _ REQUEST_TIMEOUT PROJECT This information applies to InstallScript projects. ERROR _ SERVICE _ REQUEST_TIMEOUT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo ERROR _ TIMEOUT PROJECT This information applies to InstallScript projects. ERROR _ TIMEOUT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetExtendedErrInfo
151page
Chapter 4: Predefined Constants ERR _ ABORT InstallShield InstallScript Language Reference Guide 89 ERR _ ABORT ERR _ ABORT is a predefined constant used to represent a value that is passed to or returned by one event handlers. You cannot change the value of a predefined constant. Used With • OnNextDisk ERR _ BOX _ BADPATH ERR _ BOX _ BADPATH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetErrorMsg • SetErrorTitle ERR _ BOX _ BADTAGFILE ERR _ BOX _ BADTAGFILE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetErrorMsg • SetErrorTitle ERR _ BOX _ DISKID ERR _ BOX _ DISKID is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetErrorTitle • SetErrorMsg
152page
Chapter 4: Predefined Constants ERR _ BOX _ DRIVEOPEN 90 InstallShield InstallScript Language Reference Guide ERR _ BOX _ DRIVEOPEN ERR _ BOX _ DRIVEOPEN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetErrorTitle • SetErrorMsg ERR _ IGNORE ERR _ IGNORE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or event handlers. You cannot change the value of a predefined constant. Used With • SdExceptions ERR _ NO ERR _ NO is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or event handlers. You cannot change the value of a predefined constant. Used With • SdExceptions ERR _ PERFORM _ AFTER _ REBOOT ERR _ PERFORM _ AFTER _ REBOOT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or event handlers. You cannot change the value of a predefined constant. Used With • SdExceptions
153page
Chapter 4: Predefined Constants ERR _ RETRY InstallShield InstallScript Language Reference Guide 91 ERR _ RETRY ERR _ RETRY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or event handlers. You cannot change the value of a predefined constant. Used With • OnNextDisk • SdExceptions ERR _ YES ERR _ YES is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or event handlers. You cannot change the value of a predefined constant. Used With • SdExceptions EXCLUDE _ SUBDIR EXCLUDE _ SUBDIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • XCopyFile • FindAllDirs EXCLUSIVE EXCLUSIVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SdAskOptionsList • AskOptions • SdAskOptions
154page
Chapter 4: Predefined Constants EXISTS 92 InstallShield InstallScript Language Reference Guide EXISTS EXISTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ExistsDir • ExistsDisk EXIT EXIT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Do • Handler EXTENDEDMEMORY EXTENDEDMEMORY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo EXTENSION _ ONLY EXTENSION _ ONLY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ParsePath
155page
Chapter 4: Predefined Constants FALSE InstallShield InstallScript Language Reference Guide 93 FALSE FALSE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • AskOptions • FeatureTotalSize • FeatureGetData • FeatureIsItemSelected • SdShowMsg • FeatureSelectItem • FeatureAddItem • LongPathToQuote • CtrlSetMultCurSel • SelectDir FEATURE _ FIELD _ CDROM _ FOLDER PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ CDROM _ FOLDER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureSetData FEATURE _ FIELD _ DESCRIPTION PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ DESCRIPTION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
156page
Chapter 4: Predefined Constants FEATURE _ FIELD _ DISPLAYNAME 94 InstallShield InstallScript Language Reference Guide Used With • FeatureSetData • FeatureGetData FEATURE _ FIELD _ DISPLAYNAME PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ DISPLAYNAME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureSetData • FeatureGetData FEATURE _ FIELD _ FILENEED PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ FILENEED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData FEATURE _ FIELD _ FTPLOCATION P ROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ FTPLOCATION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
157page
Chapter 4: Predefined Constants FEATURE _ FIELD _ HTTPLOCATION InstallShield InstallScript Language Reference Guide 95 Used With • FeatureGetData FEATURE _ FIELD _ HTTPLOCATION PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ HTTPLOCATION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData FEATURE _ FIELD _ IMAGE PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ IMAGE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureSetData FEATURE _ FIELD _ MISC PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ MISC is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureSetData
158page
Chapter 4: Predefined Constants FEATURE _ FIELD _ PASSWORD 96 InstallShield InstallScript Language Reference Guide • FeatureGetData FEATURE _ FIELD _ PASSWORD PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ PASSWORD is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData FEATURE _ FIELD _ SELECTED PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ SELECTED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData • FeatureSetData FEATURE _ FIELD _ SIZE PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ SIZE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData • FeatureSetData
159page
Chapter 4: Predefined Constants FEATURE _ FIELD _ STATUS InstallShield InstallScript Language Reference Guide 97 FEATURE _ FIELD _ STATUS P ROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ STATUS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData • FeatureSetData FEATURE _ FIELD _ VISIBLE PROJECT This information applies to InstallScript projects. FEATURE _ FIELD _ VISIBLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData • FeatureSetData FEATURE _ INFO _ ATTRIBUTE PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ ATTRIBUTE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo
160page
Chapter 4: Predefined Constants FEATURE _ INFO _ COMPSIZE 98 InstallShield InstallScript Language Reference Guide FEATURE _ INFO _ COMPSIZE P ROJECT This information applies to InstallScript projects. FEATURE _ INFO _ COMPSIZE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ COMPSIZE _ HIGH FEATURE _ INFO _ COMPSIZE _ HIGH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ COMPSIZE _ LOW FEATURE _ INFO _ COMPSIZE _ LOW is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ DATE PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ DATE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant.
161page
Chapter 4: Predefined Constants FEATURE _ INFO _ DATE _ EX InstallShield InstallScript Language Reference Guide 99 Used With • FeatureFileInfo FEATURE _ INFO _ DATE _ EX PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ DATE _ EX is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ LANGUAGE PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ LANGUAGE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ MD5 _ SIGNATURE FEATURE _ INFO _ MD5 _ SIGNATURE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFileInfo
162page
Chapter 4: Predefined Constants FEATURE _ INFO _ ORIGSIZE 100 InstallShield InstallScript Language Reference Guide FEATURE _ INFO _ ORIGSIZE P ROJECT This information applies to InstallScript projects. FEATURE _ INFO _ ORIGSIZE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ ORIGSIZE _ HIGH FEATURE _ INFO _ ORIGSIZE _ HIGH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ ORIGSIZE _ LOW FEATURE _ INFO _ ORIGSIZE _ LOW is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ OS PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ OS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant.
163page
Chapter 4: Predefined Constants FEATURE _ INFO _ PLATFORM _ SUITE InstallShield InstallScript Language Reference Guide 101 Used With • FeatureFileInfo FEATURE _ INFO _ PLATFORM _ SUITE PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ PLATFORM _ SUITE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ TIME PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ TIME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ VERSIONLS PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ VERSIONLS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo
164page
Chapter 4: Predefined Constants FEATURE _ INFO _ VERSIONMS 102 InstallShield InstallScript Language Reference Guide FEATURE _ INFO _ VERSIONMS P ROJECT This information applies to InstallScript projects. FEATURE _ INFO _ VERSIONMS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ INFO _ VERSIONSTR PROJECT This information applies to InstallScript projects. FEATURE _ INFO _ VERSIONSTR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • FeatureFileInfo FEATURE _ OPCOST _ UNINSTALL _ FILE FEATURE _ OPCOST _ UNINSTALL _ FILE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureAddUninstallCost • FeatureSpendUninstallCost FEATURE _ OPCOST _ UNINSTALL _ REGORINI FEATURE _ OPCOST _ UNINSTALL _ REGORINI is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
165page
Chapter 4: Predefined Constants FEATURE _ OPCOST _ UNINSTALL _ UNREGFILE InstallShield InstallScript Language Reference Guide 103 Used With • FeatureAddUninstallCost • FeatureSpendUninstallCost FEATURE _ OPCOST _ UNINSTALL _ UNREGFILE FEATURE _ OPCOST _ UNINSTALL _ UNREGFILE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureAddUninstallCost • FeatureSpendUninstallCost FEATURE _ VALUE _ CRITICAL PROJECT This information applies to InstallScript projects. FEATURE _ VALUE _ CRITICAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData FEATURE _ VALUE _ HIGHLYRECOMMENDED PROJECT This information applies to InstallScript projects. FEATURE _ VALUE _ HIGHLYRECOMMENDED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData
166page
Chapter 4: Predefined Constants FEATURE _ VALUE _ STANDARD 104 InstallShield InstallScript Language Reference Guide FEATURE _ VALUE _ STANDARD P ROJECT This information applies to InstallScript projects. FEATURE _ VALUE _ STANDARD is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureGetData File Attributes PROJECT This information applies to InstallScript projects. FILENAME FILENAME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ParsePath Table 4-1: File Attributes Attribute Description FILE _ ATTR _ NORMAL The file is a normal file. FILE _ ATTR _ ARCHIVED The file is archived. FILE _ ATTR _ DIRECTORY The file is a directory. FILE _ ATTR _ HIDDEN The file is hidden. FILE _ ATTR _ READONLY The file is read-only. FILE _ ATTR _ SYSTEM The file is a system file.
167page
Chapter 4: Predefined Constants FILENAME _ ONLY InstallShield InstallScript Language Reference Guide 105 FILENAME _ ONLY FILENAME _ ONLY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ParsePath FILE _ ATTRIBUTE FILE _ ATTRIBUTE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetFileInfo • SetFileInfo FILE _ ATTR _ ARCHIVED FILE _ ATTR _ ARCHIVED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetFileInfo FILE _ ATTR _ HIDDEN FILE _ ATTR _ HIDDEN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetFileInfo
168page
Chapter 4: Predefined Constants FILE _ ATTR _ NORMAL 106 InstallShield InstallScript Language Reference Guide FILE _ ATTR _ NORMAL FILE _ ATTR _ NORMAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetFileInfo FILE _ ATTR _ READONLY FILE _ ATTR _ READONLY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetFileInfo FILE _ ATTR _ SYSTEM FILE _ ATTR _ SYSTEM is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetFileInfo FILE _ BIN _ CUR FILE _ BIN _ CUR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SeekBytes
169page
Chapter 4: Predefined Constants FILE _ BIN _ END InstallShield InstallScript Language Reference Guide 107 FILE _ BIN _ END FILE _ BIN _ END is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SeekBytes FILE _ BIN _ START FILE _ BIN _ START is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SeekBytes FILE _ DATE FILE _ DATE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetFileInfo • SetFileInfo FILE _ EXISTS FILE _ EXISTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is
170page
Chapter 4: Predefined Constants FILE _ INSTALLED 108 InstallShield InstallScript Language Reference Guide FILE _ INSTALLED FILE _ INSTALLED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • VerSearchAndUpdateFile FILE _ IS _ LOCKED FILE _ IS _ LOCKED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • VerUpdateFile • VerSearchAndUpdateFile FILE _ LINE _ LENGTH FILE _ LINE _ LENGTH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileInsertLine • FileGrep FILE _ LOCKED FILE _ LOCKED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is
171page
Chapter 4: Predefined Constants FILE _ MD5 _ SIGNATURE InstallShield InstallScript Language Reference Guide 109 FILE _ MD5 _ SIGNATURE FILE _ MD5 _ SIGNATURE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetFileInfo FILE _ MODE _ APPEND FILE _ MODE _ APPEND is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • OpenFileMode • CreateFile FILE _ MODE _ APPEND _ UNICODE FILE _ MODE _ APPEND _ UNICODE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • OpenFileMode FILE _ MODE _ BINARY FILE _ MODE _ BINARY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • WriteBytes • OpenFileMode
172page
Chapter 4: Predefined Constants FILE _ MODE _ BINARYREADONLY 110 InstallShield InstallScript Language Reference Guide FILE _ MODE _ BINARYREADONLY FILE _ MODE _ BINARYREADONLY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • OpenFileMode FILE _ MODE _ NORMAL FILE _ MODE _ NORMAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • OpenFileMode FILE _ NOT _ FOUND FILE _ NOT _ FOUND is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • VerGetFileVersion • FileGrep • FileInsertLine • FileCompare • FileDeleteLine • VerFindFileVersion FILE _ NO _ VERSION FILE _ NO _ VERSION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
173page
Chapter 4: Predefined Constants FILE _ RD _ ONLY InstallShield InstallScript Language Reference Guide 111 Used With • VerGetFileVersion • VerSearchAndUpdateFile • VerFindFileVersion • VerUpdateFile FILE _ RD _ ONLY FILE _ RD _ ONLY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • VerUpdateFile • FileDeleteLine • FileInsertLine • VerSearchAndUpdateFile FILE _ SHARED _ COUNT PROJECT This information applies to InstallScript projects. FILE _ SHARED _ COUNT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetFileInfo FILE _ SIZE FILE _ SIZE (same as FILE_SIZE_LOW) is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetFileInfo
174page
Chapter 4: Predefined Constants FILE _ SIZE _ HIGH 112 InstallShield InstallScript Language Reference Guide FILE _ SIZE _ HIGH FILE _ SIZE _ HIGH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetFileInfo FILE _ SIZE _ LOW FILE _ SIZE _ LOW is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetFileInfo FILE _ SRC _ OLD FILE _ SRC _ OLD is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • VerSearchAndUpdateFile • VerUpdateFile FILE _ TIME FILE _ TIME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetFileInfo • SetFileInfo
175page
Chapter 4: Predefined Constants FILE _ WRITEABLE InstallShield InstallScript Language Reference Guide 113 FILE _ WRITEABLE P ROJECT This information applies to the following project types: • Installscript • InstallScript Object FILE _ WRITEABLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is FIXED _ DRIVE FIXED _ DRIVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetValidDrivesList FONT _ AVAILABLE FONT _ AVAILABLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is FULL FULL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PathAdd
176page
Chapter 4: Predefined Constants FULLSCREEN 114 InstallShield InstallScript Language Reference Guide • PathFind • PathMove • PathDelete FULLSCREEN FULLSCREEN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlaceBitmap FULLSCREENSIZE FULLSCREENSIZE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlaceBitmap FULLWINDOWMODE FULLWINDOWMODE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Enable FUNCTION _ EXPORTED P ROJECT This information applies to InstallScript projects. FUNCTION _ EXPORTED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
177page
Chapter 4: Predefined Constants GBYTES InstallShield InstallScript Language Reference Guide 115 Used With • Is GBYTES GBYTES is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ConvertSizeToUnits GREATER _ THAN GREATER _ THAN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileCompare • VerCompare GREEN GREEN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor • SetTitle HELP PROJECT This information applies to the following project types: • InstallScript • InstallScript MSI
178page
Chapter 4: Predefined Constants HKEY _ CLASSES _ ROOT 116 InstallShield InstallScript Language Reference Guide HELP is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Do • Handler HKEY _ CLASSES _ ROOT HKEY _ CLASSES _ ROOT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBSetDefaultRoot • RegDBSetKeyValueEx • RegDBDeleteKey • RegDBDeleteValue • RegDBGetKeyValueEx • RegDBKeyExist • RegDBCreateKeyEx HKEY _ CURRENT _ USER HKEY _ CURRENT _ USER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBSetDefaultRoot HKEY _ LOCAL _ MACHINE HKEY _ LOCAL _ MACHINE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
179page
Chapter 4: Predefined Constants HKEY _ USERS InstallShield InstallScript Language Reference Guide 117 NOTE Windows NT 4.0 does not allow the creation of a key directly under HKEY_LOCAL_MACHINE. Used With • RegDBConnectRegistry • InstallationInfo • RegDBSetDefaultRoot HKEY _ USERS HKEY _ USERS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. NOTE Windows NT 4.0 does not allow the creation of a key directly under HKEY_USERS. Used With • RegDBSetDefaultRoot • RegDBConnectRegistry HKEY _ USER _ SELECTABLE PROJECT This information applies to InstallScript projects. HKEY _ USER _ SELECTABLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBSetDefaultRoot HOURGLASS HOURGLASS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
180page
Chapter 4: Predefined Constants HWND _ DESKTOP 118 InstallShield InstallScript Language Reference Guide Used With • Disable • Enable HWND _ DESKTOP HWND _ DESKTOP is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetWindowHandle HWND _ INSTALL HWND _ INSTALL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetWindowHandle IDCANCEL PROJECT This information applies to InstallScript projects. IDCANCEL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDir • SelectDirEx
181page
Chapter 4: Predefined Constants IDOK InstallShield InstallScript Language Reference Guide 119 IDOK P ROJECT This information applies to InstallScript projects. IDOK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectDir • SelectDirEx IDS _ IFX _ ERROR _ INVALID _ MEDIA _ PASSWORD PROJECT This information applies to InstallScript projects. IDS _ IFX _ ERROR _ INVALID _ MEDIA _ PASSWORD is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • SdLoadString IFX _ ONNEXTDISK _ PACKAGE _ CAPTION PROJECT This information applies to InstallScript projects. IFX _ ONNEXTDISK _ PACKAGE _ CAPTION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • SdLoadString
182page
Chapter 4: Predefined Constants IFX _ ONNEXTDISK _ PACKAGE _ MSG 120 InstallShield InstallScript Language Reference Guide IFX _ ONNEXTDISK _ PACKAGE _ MSG P ROJECT This information applies to InstallScript projects. IFX _ ONNEXTDISK _ PACKAGE _ MSG is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • SdLoadString INCLUDE _ SUBDIR INCLUDE _ SUBDIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FindAllDirs • XCopyFile INDVFILESTATUS INDVFILESTATUS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Disable • SetStatusWindow • Enable INFORMATION INFORMATION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
183page
Chapter 4: Predefined Constants ISDIFX _ OPTION _ DONT _ ASSOCIATE InstallShield InstallScript Language Reference Guide 121 Used With • MessageBox • SprintfBox ISDIFX _ OPTION _ DONT _ ASSOCIATE ISDIFX _ OPTION _ DONT _ ASSOCIATE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageInstall • DIFxDriverPackageUninstall ISDIFX _ OPTION _ DONT _ RESOLVE _ TEXTSUBS ISDIFX _ OPTION _ DONT _ RESOVE _ TEXTSUBS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageGetPath • DIFxDriverPackageInstall • DIFxDriverPackagePreinstall • DIFxDriverPackageUninstall ISDIFX _ OPTION _ LOG _ IN _ DRIVER _ PACKAGE _ PATH ISDIFX _ OPTION _ LOG _ IN _ DRIVER _ PACKAGE _ PATH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageInstall • DIFxDriverPackagePreinstall
184page
Chapter 4: Predefined Constants ISDIFX _ OPTION _ NO _ REPAIR 122 InstallShield InstallScript Language Reference Guide ISDIFX _ OPTION _ NO _ REPAIR ISDIFX _ OPTION _ NO _ REPAIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DIFxDriverPackageInstall • DIFxDriverPackagePreinstall ISERR _ GEN _ FAILURE PROJECT This information applies to InstallScript projects. ISERR _ GEN _ FAILURE is a predefined constant used to represent the value that is returned by built-in functions when they fail and more specific information on the cause of the failure is not available. You cannot change the value of a predefined constant. ISERR _ SUCCESS PROJECT This information applies to the following project types: • InstallScript • InstallScript MSI ISERR _ SUCCESS is a predefined constant used to represent the value that is returned by built-in functions when they are successful. You cannot change the value of a predefined constant. ISLANG _ AFRIKAANS ISLANG _ AFRIKAANS is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
185page
Chapter 4: Predefined Constants ISLANG _ AFRIKAANS _ STANDARD InstallShield InstallScript Language Reference Guide 123 ISLANG _ AFRIKAANS _ STANDARD ISLANG _ AFRIKAANS _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ALBANIAN ISLANG _ ALBANIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ALBANIAN _ STANDARD ISLANG _ ALBANIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ALL ISLANG _ ALL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterLanguage ISLANG _ ARABIC ISLANG _ ARABIC is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ ALGERIA ISLANG _ ARABIC _ ALGERIA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
186page
Chapter 4: Predefined Constants ISLANG _ ARABIC _ BAHRAIN 124 InstallShield InstallScript Language Reference Guide ISLANG _ ARABIC _ BAHRAIN ISLANG _ ARABIC _ BAHRAIN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ EGYPT ISLANG _ ARABIC _ EGYPT is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ IRAQ ISLANG _ ARABIC _ IRAQ is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ JORDAN ISLANG _ ARABIC _ JORDAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ KUWAIT ISLANG _ ARABIC _ KUWAIT is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ LEBANON ISLANG _ ARABIC _ LEBANON is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ LIBYA ISLANG _ ARABIC _ LIBYA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
187page
Chapter 4: Predefined Constants ISLANG _ ARABIC _ MOROCCO InstallShield InstallScript Language Reference Guide 125 ISLANG _ ARABIC _ MOROCCO ISLANG _ ARABIC _ MOROCCO is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ OMAN ISLANG _ ARABIC _ OMAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _QATAR ISLANG _ ARABIC _QATAR is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ SAUDIARABIA ISLANG _ ARABIC _ SAUDIARABIA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ SYRIA ISLANG _ ARABIC _ SYRIA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ TUNISIA ISLANG _ ARABIC _ TUNISIA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ARABIC _ UAE ISLANG _ ARABIC _ UAE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
188page
Chapter 4: Predefined Constants ISLANG _ ARABIC _ YEMEN 126 InstallShield InstallScript Language Reference Guide ISLANG _ ARABIC _ YEMEN ISLANG _ ARABIC _ YEMEN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ BASQUE ISLANG _ BASQUE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ BASQUE_STANDARD ISLANG _ BASQUE_STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ BELARUSIAN ISLANG _ BELARUSIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ BELARUSIAN _ STANDARD ISLANG _ BELARUSIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ BULGARIAN ISLANG _ BULGARIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ BULGARIAN _ STANDARD ISLANG _ BULGARIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
189page
Chapter 4: Predefined Constants ISLANG _ CATALAN InstallShield InstallScript Language Reference Guide 127 ISLANG _ CATALAN ISLANG _ CATALAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CATALAN _ STANDARD ISLANG _ CATALAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CHINESE ISLANG _ CHINESE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CHINESE _ HONGKONG ISLANG _ CHINESE _ HONGKONG is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CHINESE _ PRC ISLANG _ CHINESE _ PRC is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CHINESE _ SINGAPORE ISLANG _ CHINESE _ SINGAPORE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CHINESE _ TAIWAN ISLANG _ CHINESE _ TAIWAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
190page
Chapter 4: Predefined Constants ISLANG _ CROATIAN 128 InstallShield InstallScript Language Reference Guide ISLANG _ CROATIAN ISLANG _ CROATIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CROATIAN _ STANDARD ISLANG _ CROATIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CZECH ISLANG _ CZECH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ CZECH _ STANDARD ISLANG _ CZECH _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ DANISH ISLANG _ DANISH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ DANISH _ STANDARD ISLANG _ DANISH _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ DUTCH ISLANG _ DUTCH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
191page
Chapter 4: Predefined Constants ISLANG _ DUTCH _ BELGIAN InstallShield InstallScript Language Reference Guide 129 ISLANG _ DUTCH _ BELGIAN ISLANG _ DUTCH _ BELGIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ DUTCH _ STANDARD ISLANG _ DUTCH _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH ISLANG _ ENGLISH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ AUSTRALIAN ISLANG _ ENGLISH _ AUSTRALIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ BELIZE ISLANG _ ENGLISH _ BELIZE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ CANADIAN ISLANG _ ENGLISH _ CANADIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ CARIBBEAN ISLANG _ ENGLISH _ CARIBBEAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
192page
Chapter 4: Predefined Constants ISLANG _ ENGLISH _ IRELAND 130 InstallShield InstallScript Language Reference Guide ISLANG _ ENGLISH _ IRELAND ISLANG _ ENGLISH _ IRELAND is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ JAMAICA ISLANG _ ENGLISH _ JAMAICA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ NEWZEALAND ISLANG _ ENGLISH _ NEWZEALAND is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ SOUTHAFRICA ISLANG _ ENGLISH _ SOUTHAFRICA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ TRINIDAD ISLANG _ ENGLISH _ TRINIDAD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ UNITEDKINGDOM ISLANG _ ENGLISH _ UNITEDKINGDOM is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ENGLISH _ UNITEDSTATES ISLANG _ ENGLISH _ UNITEDSTATES is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
193page
Chapter 4: Predefined Constants ISLANG _ ESTONIAN InstallShield InstallScript Language Reference Guide 131 ISLANG _ ESTONIAN ISLANG _ ESTONIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ESTONIAN _ STANDARD ISLANG _ ESTONIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FAEROESE ISLANG _ FAEROESE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FAEROESE _ STANDARD ISLANG _ FAEROESE _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FARSI ISLANG _ FARSI is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FARSI _ STANDARD ISLANG _ FARSI _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FINNISH ISLANG _ FINNISH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
194page
Chapter 4: Predefined Constants ISLANG _ FINNISH _ STANDARD 132 InstallShield InstallScript Language Reference Guide ISLANG _ FINNISH _ STANDARD ISLANG _ FINNISH _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FRENCH ISLANG _ FRENCH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FRENCH _ BELGIAN ISLANG _ FRENCH _ BELGIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FRENCH _ CANADIAN ISLANG _ FRENCH _ CANADIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FRENCH _ LUXEMBOURG ISLANG _ FRENCH _ LUXEMBOURG is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FRENCH _ STANDARD ISLANG _ FRENCH _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ FRENCH _ SWISS ISLANG _ FRENCH _ SWISS is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
195page
Chapter 4: Predefined Constants ISLANG _ GERMAN InstallShield InstallScript Language Reference Guide 133 ISLANG _ GERMAN ISLANG _ GERMAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ GERMAN _ AUSTRIAN ISLANG _ GERMAN _ AUSTRIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ GERMAN _ LIECHTENSTEIN ISLANG _ GERMAN _ LIECHTENSTEIN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ GERMAN _ LUXEMBOURG ISLANG _ GERMAN _ LUXEMBOURG is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ GERMAN _ STANDARD ISLANG _ GERMAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ GERMAN _ SWISS ISLANG _ GERMAN _ SWISS is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ GREEK ISLANG _ GREEK is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
196page
Chapter 4: Predefined Constants ISLANG _ GREEK _ STANDARD 134 InstallShield InstallScript Language Reference Guide ISLANG _ GREEK _ STANDARD ISLANG _ GREEK _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ HEBREW ISLANG _ HEBREW is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ HEBREW _ STANDARD ISLANG _ HEBREW _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ HUNGARIAN ISLANG _ HUNGARIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ HUNGARIAN _ STANDARD ISLANG _ HUNGARIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ICELANDIC ISLANG _ ICELANDIC is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ICELANDIC _ STANDARD ISLANG _ ICELANDIC _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
197page
Chapter 4: Predefined Constants ISLANG _ INDONESIAN InstallShield InstallScript Language Reference Guide 135 ISLANG _ INDONESIAN ISLANG _ INDONESIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ INDONESIAN _ STANDARD ISLANG _ INDONESIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ITALIAN ISLANG _ ITALIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ITALIAN _ STANDARD ISLANG _ ITALIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ITALIAN _ SWISS ISLANG _ ITALIAN _ SWISS is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ JAPANESE ISLANG _ JAPANESE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ JAPANESE _ STANDARD ISLANG _ JAPANESE _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
198page
Chapter 4: Predefined Constants ISLANG _ KOREAN 136 InstallShield InstallScript Language Reference Guide ISLANG _ KOREAN ISLANG _ KOREAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ KOREAN _ JOHAB ISLANG _ KOREAN _ JOHAB is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ KOREAN _ STANDARD ISLANG _ KOREAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ LATVIAN ISLANG _ LATVIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ LATVIAN _ STANDARD ISLANG _ LATVIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ LITHUANIAN ISLANG _ LITHUANIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ LITHUANIAN _ STANDARD ISLANG _ LITHUANIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
199page
Chapter 4: Predefined Constants ISLANG _ NORWEGIAN InstallShield InstallScript Language Reference Guide 137 ISLANG _ NORWEGIAN ISLANG _ NORWEGIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ NORWEGIAN _ BOKMAL ISLANG _ NORWEGIAN _ BOKMAL is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ NORWEGIAN _ NYNORSK ISLANG _ NORWEGIAN _ NYNORSK is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ POLISH ISLANG _ POLISH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ POLISH _ STANDARD ISLANG _ POLISH _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ PORTUGUESE ISLANG _ PORTUGUESE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ PORTUGUESE _ BRAZILIAN ISLANG _ PORTUGUESE _ BRAZILIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
200page
Chapter 4: Predefined Constants ISLANG _ PORTUGUESE _ STANDARD 138 InstallShield InstallScript Language Reference Guide ISLANG _ PORTUGUESE _ STANDARD ISLANG _ PORTUGUESE _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ROMANIAN ISLANG _ ROMANIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ ROMANIAN _ STANDARD ISLANG _ ROMANIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ RUSSIAN ISLANG _ RUSSIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ RUSSIAN _ STANDARD ISLANG _ RUSSIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SERBIAN _ CYRILLIC ISLANG _ SERBIAN _ CYRILLIC is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SERBIAN _ LATIN ISLANG _ SERBIAN _ LATIN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
201page
Chapter 4: Predefined Constants ISLANG _ SLOVAK InstallShield InstallScript Language Reference Guide 139 ISLANG _ SLOVAK ISLANG _ SLOVAK is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SLOVAK _ STANDARD ISLANG _ SLOVAK _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SLOVENIAN ISLANG _ SLOVENIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SLOVENIAN _ STANDARD ISLANG _ SLOVENIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH ISLANG _ SPANISH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ ARGENTINA ISLANG _ SPANISH _ ARGENTINA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ BOLIVIA ISLANG _ SPANISH _ BOLIVIA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
202page
Chapter 4: Predefined Constants ISLANG _ SPANISH _ CHILE 140 InstallShield InstallScript Language Reference Guide ISLANG _ SPANISH _ CHILE ISLANG _ SPANISH _ CHILE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ COLOMBIA ISLANG _ SPANISH _ COLOMBIA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ COSTARICA ISLANG _ SPANISH _ COSTARICA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ DOMINICANREPUBLIC ISLANG _ SPANISH _ DOMINICANREPUBLIC is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ ECUADOR ISLANG _ SPANISH _ ECUADOR is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ ELSALVADOR ISLANG _ SPANISH _ ELSALVADOR is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ GUATEMALA ISLANG _ SPANISH _ GUATEMALA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
203page
Chapter 4: Predefined Constants ISLANG _ SPANISH _ HONDURAS InstallShield InstallScript Language Reference Guide 141 ISLANG _ SPANISH _ HONDURAS ISLANG _ SPANISH _ HONDURAS is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ MEXICAN ISLANG _ SPANISH _ MEXICAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ MODERNSORT ISLANG _ SPANISH _ MODERNSORT is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ NICARAGUA ISLANG _ SPANISH _ NICARAGUA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ PANAMA ISLANG _ SPANISH _ PANAMA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ PARAGUAY ISLANG _ SPANISH _ PARAGUAY is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ PERU ISLANG _ SPANISH _ PERU is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
204page
Chapter 4: Predefined Constants ISLANG _ SPANISH _ PUERTORICO 142 InstallShield InstallScript Language Reference Guide ISLANG _ SPANISH _ PUERTORICO ISLANG _ SPANISH _ PUERTORICO is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ TRADITIONALSORT ISLANG _ SPANISH _ TRADITIONALSORT is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ URUGUAY ISLANG _ SPANISH _ URUGUAY is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SPANISH _ VENEZUELA ISLANG _ SPANISH _ VENEZUELA is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SWEDISH ISLANG _ SWEDISH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SWEDISH _ FINLAND ISLANG _ SWEDISH _ FINLAND is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ SWEDISH _ STANDARD ISLANG _ SWEDISH _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
205page
Chapter 4: Predefined Constants ISLANG _ THAI InstallShield InstallScript Language Reference Guide 143 ISLANG _ THAI ISLANG _ THAI is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ THAI _ STANDARD ISLANG _ THAI _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ TURKISH ISLANG _ TURKISH is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ TURKISH _ STANDARD ISLANG _ TURKISH _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ UKRAINIAN ISLANG _ UKRAINIAN is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ UKRAINIAN _ STANDARD ISLANG _ UKRAINIAN _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISLANG _ VIETNAMESE ISLANG _ VIETNAMESE is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs.
206page
Chapter 4: Predefined Constants ISLANG _ VIETNAMESE _ STANDARD 144 InstallShield InstallScript Language Reference Guide ISLANG _ VIETNAMESE _ STANDARD ISLANG _ VIETNAMESE _ STANDARD is a predefined constant that corresponds to a Windows language ID. For more information about how to use this constant, see Language IDs. ISOSL _ ALL ISOSL _ ALL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOSL _ NT40 ISOSL _ NT40 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOSL _ NT40 _ ALPHA ISOSL _ NT40 _ ALPHA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOSL _ SUPPORTED ISOSL _ SUPPORTED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
207page
Chapter 4: Predefined Constants ISOSL _ WIN2000 InstallShield InstallScript Language Reference Guide 145 Used With • FeatureFilterOS ISOSL _ WIN2000 ISOSL _ WIN2000 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOSL _ WIN2000 _ ALPHA ISOSL _ WIN2000 _ ALPHA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOSL _ WIN95 ISOSL _ WIN95 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOSL _ WIN98 ISOSL _ WIN98 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS
208page
Chapter 4: Predefined Constants ISOSL _ WINME 146 InstallShield InstallScript Language Reference Guide See Also Predefined Constants ISOSL _ WINME PROJECT This information applies to InstallScript projects. ISOSL _ WINME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOSL _ WINSERVER2003 ISOSL _ WINSERVER2003 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOSL _ WINXP ISOSL _ WINXP is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ ALL PROJECT This information applies to InstallScript projects.
209page
Chapter 4: Predefined Constants ISOS _ ST _ BACKOFFICE InstallShield InstallScript Language Reference Guide 147 ISOS _ ST _ ALL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ BACKOFFICE PROJECT This information applies to InstallScript projects. ISOS _ ST _ BACKOFFICE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ DATACENTER PROJECT This information applies to InstallScript projects. ISOS _ ST _ DATACENTER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ ENTERPRISE PROJECT This information applies to InstallScript projects. ISOS _ ST _ ENTERPRISE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
210page
Chapter 4: Predefined Constants ISOS _ ST _ PROC _ ARCH _ 32 148 InstallShield InstallScript Language Reference Guide Used With • FeatureFilterOS ISOS _ ST _ PROC _ ARCH _ 32 PROJECT This information applies to InstallScript projects. ISOS _ ST _ PROC _ ARCH _ 32 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ PROC _ ARCH _ AMD64 PROJECT This information applies to InstallScript projects. ISOS _ ST _ PROC _ ARCH _ AMD64 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ PROC _ ARCH _ IA64 PROJECT This information applies to InstallScript projects. ISOS _ ST _ PROC _ ARCH _ IA64 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS
211page
Chapter 4: Predefined Constants ISOS _ ST _ SERVER InstallShield InstallScript Language Reference Guide 149 ISOS _ ST _ SERVER P ROJECT This information applies to InstallScript projects. ISOS _ ST _ SERVER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ SMALLBUSINESS PROJECT This information applies to InstallScript projects. ISOS _ ST _ SMALLBUSINESS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ SMALLBUSINESS _ RESTRICTED PROJECT This information applies to InstallScript projects. ISOS _ ST _ SMALLBUSINESS _ RESTRICTED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS
212page
Chapter 4: Predefined Constants ISOS _ ST _ TERMINAL 150 InstallShield InstallScript Language Reference Guide ISOS _ ST _ TERMINAL P ROJECT This information applies to InstallScript projects. ISOS _ ST _ TERMINAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ WORKSTATION PROJECT This information applies to InstallScript projects. ISOS _ ST _ WORKSTATION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISOS _ ST _ XP _ HOME PROJECT This information applies to InstallScript projects. ISOS _ ST _ XP _ HOME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS
213page
Chapter 4: Predefined Constants ISOS _ ST _ XP _ PRO InstallShield InstallScript Language Reference Guide 151 ISOS _ ST _ XP _ PRO P ROJECT This information applies to InstallScript projects. ISOS _ ST _ XP _ PRO is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFilterOS ISUS _ AGENT _ FEATURE This constant contains the name of the Update Service agent sub-feature. ISUS _ MAIN _ FEATURE This script variable serves the same purpose as the UPDATESERVICECOMPONENT which specifies the component with the files needed for installing Update Service. The UPDATESERVICECOMPONENT is still available for use. ISUS _ TEXTSUB _ HOST ISUS _ TEXTSUB _ HOST is a predefined constant used to represent the Host property value in the InstallShield user interface. It can be set as a string value. Used With • TextSubGetValue ISUS _ TEXTSUB _ INTERVAL ISUS _ TEXTSUB _ INTERVAL is a predefined constant used to represent the Update Check Interval property value in the InstallShield user interface. ISUS _ TEXTSUB _ INTERVAL can be set as a numeric string indicating the number of days. Used With • TextSubGetValue
214page
Chapter 4: Predefined Constants ISUS _ TEXTSUB _ LANGUAGE 152 InstallShield InstallScript Language Reference Guide ISUS _ TEXTSUB _ LANGUAGE ISUS _ TEXTSUB _ LANGUAGE is a predefined constant used to represent the language property value in the InstallShield user interface. ISUS _ TEXTSUB _ LANGUAGE can be set as a numeric string to indicate the language (decimal value). Used With • TextSubGetValue ISUS _ TEXTSUB _ LOGO ISUS _ TEXTSUB _ LOGO is a predefined constant used to represent the company logo property in the InstallShield user interface. ISUS_TEXTSUB_LOGO can be set as a string. Used With • TextSubGetValue ISUS _ TEXTSUB _ MANAGER ISUS _ TEXTSUB _ MANAGER is a predefined constant used to represent the Install Manager property in the InstallShield user interface. ISUS_TEXTSUB_MANAGER should not be set manually. Call UpdateServiceEnableUpdateManagerInstall instead. Used With • TextSubGetValue ISUS _ TEXTSUB _ VERSION ISUS _ TEXTSUB _ VERSION is a predefined constant used to represent the version number in the InstallShield user interface. ISUS_TEXTSUB_VERSION can be set as a string. Used With • TextSubGetValue
215page
Chapter 4: Predefined Constants ISUS _ UPDATEMANAGER _ FEATURE InstallShield InstallScript Language Reference Guide 153 ISUS _ UPDATEMANAGER _ FEATURE This constant contains the name of the Update Service Manager feature. The name of the Update Service Manager feature should be enabled or disabled by calling UpdateServiceEnableUpdateManagerInstall. IS _ 386 IS _ 386 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ 486 IS _ 486 is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ ALPHA IS _ ALPHA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ CDROM IS _ CDROM is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
216page
Chapter 4: Predefined Constants IS _ EGA 154 InstallShield InstallScript Language Reference Guide Used With • GetSystemInfo IS _ EGA IS _ EGA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ FIXED IS _ FIXED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ FOLDER IS _ FOLDER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • QueryProgItem • ReplaceFolderIcon IS _ ITEM IS _ ITEM is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • QueryProgItem
217page
Chapter 4: Predefined Constants IS _ PENTIUM InstallShield InstallScript Language Reference Guide 155 • ReplaceFolderIcon IS _ PENTIUM IS _ PENTIUM is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ REMOTE IS _ REMOTE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ REMOVABLE IS _ REMOVABLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ SVGA IS _ SVGA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo
218page
Chapter 4: Predefined Constants IS _ UNKNOWN 156 InstallShield InstallScript Language Reference Guide IS _ UNKNOWN IS _ UNKNOWN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ UVGA IS _ UVGA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ VGA IS _ VGA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ WINDOWS IS _ WINDOWS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo
219page
Chapter 4: Predefined Constants IS _ WINDOWS9X InstallShield InstallScript Language Reference Guide 157 IS _ WINDOWS9X IS _ WINDOWS9X is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ WINDOWSNT IS _ WINDOWSNT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo IS _ XVGA IS _ XVGA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo KBYTES KBYTES is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ConvertSizeToUnits
220page
Chapter 4: Predefined Constants LAAW _ OPTION _ HIDDEN 158 InstallShield InstallScript Language Reference Guide LAAW _ OPTION _ HIDDEN P ROJECT This information applies to InstallScript projects. LAAW _ OPTION _ HIDDEN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait LAAW _ OPTION _ MAXIMIZED PROJECT This information applies to InstallScript projects. LAAW _ OPTION _ MAXIMIZED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait LAAW _ OPTION _ MINIMIZED PROJECT This information applies to InstallScript projects. LAAW _ OPTION _ MINIMIZED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait
221page
Chapter 4: Predefined Constants LAAW _ OPTION _ NO _ CHANGEDIRECTORY InstallShield InstallScript Language Reference Guide 159 LAAW _ OPTION _ NO _ CHANGEDIRECTORY P ROJECT This information applies to InstallScript projects. LAAW _ OPTION _ NO _ CHANGEDIRECTORY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait LAAW _ OPTION _ NOWAIT PROJECT This information applies to InstallScript projects. LAAW _ OPTION _ NOWAIT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait LAAW _ OPTION _ SET _ BATCH _ INSTALL PROJECT This information applies to InstallScript projects. LAAW _ OPTION _ SET _ BATCH _ INSTALL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait
222page
Chapter 4: Predefined Constants LAAW _ OPTION _ SHOW _ HOURGLASS 160 InstallShield InstallScript Language Reference Guide LAAW _ OPTION _ SHOW _ HOURGLASS P ROJECT This information applies to InstallScript projects. LAAW _ OPTION _ SHOW _ HOURGLASS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait LAAW _ OPTION _ USE _ CALLBACK LAAW _ OPTION _ USE _ CALLBACK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait LAAW _ OPTION _ WAIT PROJECT This information applies to InstallScript projects. LAAW _ OPTION _ WAIT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DoInstall • LaunchAppAndWait
223page
Chapter 4: Predefined Constants LANG _ SUPPORTED InstallShield InstallScript Language Reference Guide 161 LANG _ SUPPORTED LANG _ SUPPORTED is a predefined constant that is used to specify the language that an installation supports. You cannot change the value of a predefined constant. Used With • Is LANGUAGE LANGUAGE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo LESS _ THAN LESS _ THAN is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileCompare • VerCompare LINE _ NUMBER LINE _ NUMBER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FileDeleteLine • FileInsertLine
224page
Chapter 4: Predefined Constants LISTBOX _ ENTER 162 InstallShield InstallScript Language Reference Guide LISTBOX _ ENTER LISTBOX _ ENTER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlGetSubCommand LISTBOX _ SELECT LISTBOX _ SELECT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • CtrlGetSubCommand LISTFIRST LISTFIRST is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ListSetIndex LISTLAST LISTLAST is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ListSetIndex
225page
Chapter 4: Predefined Constants LISTNEXT InstallShield InstallScript Language Reference Guide 163 LISTNEXT LISTNEXT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ListSetIndex LISTPREV LISTPREV is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ListSetIndex LIST _ NULL LIST _ NULL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ListCreate LOCKEDFILE LOCKEDFILE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • XCopyFile • InstallationInfo • VerUpdateFile • DeinstallStart
226page
Chapter 4: Predefined Constants LOGGING 164 InstallShield InstallScript Language Reference Guide LOGGING LOGGING is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DeinstallStart • Disable • Enable • InstallationInfo LOWER _ LEFT LOWER _ LEFT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlaceBitmap • PlaceWindow LOWER _ RIGHT LOWER _ RIGHT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlaceBitmap • PlaceWindow LWFT _ OPTION _ WRITE _ AS _ ANSI LWFT _ OPTION _ WRITE _ AS _ ANSI is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
227page
Chapter 4: Predefined Constants LWFT _ OPTION _ WRITE _ AS _ UNICODE InstallShield InstallScript Language Reference Guide 165 Used With • ListWriteToFileEx LWFT _ OPTION _ WRITE _ AS _ UNICODE LWFT _ OPTION _ WRITE _ AS _ UNICODE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ListWriteToFileEx MAGENTA MAGENTA is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor • SetTitle MATH _ COPROCESSOR MATH _ COPROCESSOR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is MBYTES MBYTES is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ConvertSizeToUnits
228page
Chapter 4: Predefined Constants MEDIA _ FIELD _ ADDREMOVE _ NOMODIFY 166 InstallShield InstallScript Language Reference Guide MEDIA _ FIELD _ ADDREMOVE _ NOMODIFY P ROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ ADDREMOVE _ NOMODIFY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx MEDIA _ FIELD _ ADDREMOVE _ NOREMOVE PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ ADDREMOVE _ NOREMOVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx MEDIA _ FIELD _ COMPANY _ NAME PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ COMPANY _ NAME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData
229page
Chapter 4: Predefined Constants MEDIA _ FIELD _ MEDIA _ FLAGS InstallShield InstallScript Language Reference Guide 167 MEDIA _ FIELD _ MEDIA _ FLAGS P ROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ MEDIA _ FLAGS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData MEDIA _ FIELD _ PREVIOUS _ VERSIONS PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PREVIOUS _ VERSIONS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData MEDIA _ FIELD _ PRODUCT _ COMMENTS PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ COMMENTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx
230page
Chapter 4: Predefined Constants MEDIA _ FIELD _ PRODUCT _ EXE 168 InstallShield InstallScript Language Reference Guide MEDIA _ FIELD _ PRODUCT _ EXE P ROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ EXE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData MEDIA _ FIELD _ PRODUCT _ ICON PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ ICON is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx MEDIA _ FIELD _ PRODUCT _ NAME PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ NAME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData
231page
Chapter 4: Predefined Constants MEDIA _ FIELD _ PRODUCT _ README InstallShield InstallScript Language Reference Guide 169 MEDIA _ FIELD _ PRODUCT _ README P ROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ README is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx MEDIA _ FIELD _ PRODUCT _ SUPPORT _ CONTACT PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ SUPPORT _ CONTACT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx MEDIA _ FIELD _ PRODUCT _ SUPPORT _ PHONE PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ SUPPORT _ PHONE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx
232page
Chapter 4: Predefined Constants MEDIA _ FIELD _ PRODUCT _ SUPPORT _ URL 170 InstallShield InstallScript Language Reference Guide MEDIA _ FIELD _ PRODUCT _ SUPPORT _ URL P ROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ SUPPORT _ URL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx MEDIA _ FIELD _ PRODUCT _ UPDATE _ URL PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ UPDATE _ URL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx MEDIA _ FIELD _ PRODUCT _ URL PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ URL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData • MediaGetDataEx
233page
Chapter 4: Predefined Constants MEDIA _ FIELD _ PRODUCT _ VERSION InstallShield InstallScript Language Reference Guide 171 MEDIA _ FIELD _ PRODUCT _ VERSION P ROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ PRODUCT _ VERSION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData MEDIA _ FIELD _ TARGETDIR PROJECT This information applies to InstallScript projects. MEDIA _ FIELD _ TARGETDIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData MEDIA _ FLAG _ FORMAT _ DIFFERENTIAL PROJECT This information applies to InstallScript projects. MEDIA _ FLAG _ FORMAT _ DIFFERENTIAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData
234page
Chapter 4: Predefined Constants MEDIA _ FLAG _ FORMAT _ PATCH 172 InstallShield InstallScript Language Reference Guide MEDIA _ FLAG _ FORMAT _ PATCH P ROJECT This information applies to InstallScript projects. MEDIA _ FLAG _ FORMAT _ PATCH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData MEDIA _ FLAG _ UPDATEMODE _ SUPPORTED PROJECT This information applies to InstallScript projects. MEDIA _ FLAG _ UPDATEMODE _ SUPPORTED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • MediaGetData MEDIA _ PASSWORD _ KEY PROJECT This information applies to InstallScript projects. MEDIA _ PASSWORD _ KEY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • LogReadCustomString • LogWriteCustomString
235page
Chapter 4: Predefined Constants METAFILE InstallShield InstallScript Language Reference Guide 173 METAFILE METAFILE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SizeWindow MMEDIA _ AVI MMEDIA _ AVI is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlayMMedia • PlaceWindow • SizeWindow MMEDIA _ MIDI MMEDIA _ MIDI is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlayMMedia MMEDIA _ PLAYASYNCH MMEDIA _ PLAYASYNCH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlayMMedia
236page
Chapter 4: Predefined Constants MMEDIA _ PLAYCONTINUOUS 174 InstallShield InstallScript Language Reference Guide MMEDIA _ PLAYCONTINUOUS MMEDIA _ PLAYCONTINUOUS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlayMMedia MMEDIA _ PLAYSYNCH MMEDIA _ PLAYSYNCH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlayMMedia MMEDIA _ STOP MMEDIA _ STOP is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlayMMedia MMEDIA _ WAVE MMEDIA _ WAVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PlayMMedia
237page
Chapter 4: Predefined Constants MODIFY InstallShield InstallScript Language Reference Guide 175 MODIFY P ROJECT This information applies to InstallScript projects. MODIFY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SdWelcomeMaint NEXT NEXT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SelectFolder • FeatureDialog • SdFinish • SdBitmap • SdFinishReboot • SdDisplayTopics • SdRegisterUserEx • SdShowAnyDialog • AskDestPath • SdShowDlgEdit2 • SdAskOptionsList • SdShowDlgEdit3 • SdSelectFolder • SdFeatureDialog2 • SdFeatureMult • Welcome • SdShowInfoList • SdStartCopy • SdWelcome
238page
Chapter 4: Predefined Constants NEXTBUTTON 176 InstallShield InstallScript Language Reference Guide • SdRegisterUser • SdAskDestPath • AskText • SdFeatureDialog • SdFeatureDialogAdv • SdShowDlgEdit1 • SdShowFileMods • SdAskOptions • AskPath • AskOptions NEXTBUTTON NEXTBUTTON is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Disable • Enable • Is NO NO is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SdConfirmNewDir • SdConfirmRegistration • AskYesNo NONEXCLUSIVE NONEXCLUSIVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
239page
Chapter 4: Predefined Constants NORMALMODE InstallShield InstallScript Language Reference Guide 177 Used With • SdAskOptionsList • AskOptions • SdAskOptions NORMALMODE NORMALMODE is a predefined constant that can be used to test whether or not a setup is running in silent mode. For more information, refer to the InstallShield system variable MODE. NORMAL _ PRIORITY _ CLASS PROJECT This information applies to InstallScript projects. NORMAL _ PRIORITY _ CLASS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • SERVICE _ IS _ PARAMS NOSET NOSET is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • EzBatchAddString NOTEXISTS NOTEXISTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
240page
Chapter 4: Predefined Constants NO _ SUBDIR 178 InstallShield InstallScript Language Reference Guide Used With • ExistsDir • ExistsDisk NO _ SUBDIR PROJECT This information applies to InstallScript projects. NO _ SUBDIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • FeatureFileEnum NULL NULL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ReplaceFolderIcon • QueryProgItem • AddFolderIcon • FindWindow NUMBERLIST NUMBERLIST is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ListCreate
241page
Chapter 4: Predefined Constants OFF InstallShield InstallScript Language Reference Guide 179 OFF OFF is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • StatusUpdate OK OK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • EnterDisk ON ON is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • StatusUpdate ONLYDIR ONLYDIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • DeleteDir OTHER _ FAILURE OTHER _ FAILURE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
242page
Chapter 4: Predefined Constants OUT _ OF _ DISK _ SPACE 180 InstallShield InstallScript Language Reference Guide Used With • FileDeleteLine • VerUpdateFile • FileCompare • FileGrep • FileInsertLine OUT _ OF _ DISK _ SPACE OUT _ OF _ DISK _ SPACE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • VerUpdateFile • FileInsertLine • FileDeleteLine • VerSearchAndUpdateFile PARALLEL PARALLEL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • GetSystemInfo PARTIAL PARTIAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • PathAdd • PathFind • PathMove
243page
Chapter 4: Predefined Constants PATH InstallShield InstallScript Language Reference Guide 181 • PathDelete PATH PATH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • ParsePath PATH _ EXISTS » InstallScript Language Reference PATH _ EXISTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is PCRESTORE PROJECT This information applies to InstallScript projects. PCRESTORE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Disable • Enable PERSONAL PERSONAL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
244page
Chapter 4: Predefined Constants READ _ CONTROL 182 InstallShield InstallScript Language Reference Guide Used With • ProgDefGroupType READ _ CONTROL PROJECT This information applies to InstallScript projects. READ _ CONTROL is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • SERVICE _ IS _ PARAMS REBOOTED REBOOTED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is RECORDMODE RECORDMODE is a predefined constant that can be used to test whether or not a setup is automatically generating a silent setup file (.iss file), which is a record of the setup input, in the Windows folder. For more information, refer to the InstallScript system variable MODE. RED RED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • SetColor • SetTitle
245page
Chapter 4: Predefined Constants REGDBREMOTEREGCONNECTED InstallShield InstallScript Language Reference Guide 183 REGDBREMOTEREGCONNECTED REGDBREMOTEREGCONNECTED is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • Is REGDB _ APPPATH REGDB _ APPPATH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ APPPATH _ DEFAULT REGDB _ APPPATH _ DEFAULT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ BINARY REGDB _ BINARY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBSetAppInfo • RegDBGetKeyValueEx • RegDBSetKeyValueEx
246page
Chapter 4: Predefined Constants REGDB _ ERR _ CONNECTIONEXISTS 184 InstallShield InstallScript Language Reference Guide • RegDBGetAppInfo • RegDBSetKeyValueEx REGDB _ ERR _ CONNECTIONEXISTS REGDB _ ERR _ CONNECTIONEXISTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBConnectRegistry REGDB _ ERR _ CORRUPTEDREGISTRY REGDB _ ERR _ CORRUPTEDREGISTRY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBConnectRegistry REGDB _ ERR _ INITIALIZATION REGDB _ ERR _ INITIALIZATION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBConnectRegistry REGDB _ ERR _ INVALIDHANDLE REGDB _ ERR _ INVALIDHANDLE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBConnectRegistry
247page
Chapter 4: Predefined Constants REGDB _ ERR _ INVALIDNAME InstallShield InstallScript Language Reference Guide 185 REGDB _ ERR _ INVALIDNAME REGDB _ ERR _ INVALIDNAME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBConnectRegistry REGDB _ KEYPATH _ APPPATHS REGDB _ KEYPATH _ APPPATHS is a predefined constant whose value is the registry location (not including the root key) of the general application paths key, that is, Software\Microsoft\Windows\CurrentVersion\App Paths\. You can use this constant to specify a key when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ KEYPATH _ DOTNET _ 10 REGDB _ KEYPATH _ DOTNET _ 10 is a predefined constant whose value is the registry location (not including the root key) of the registry key for version 1.0 of the .NET Framework, that is, Software\Microsoft\NET Framework Setup\NDP\v2.0.50727\. You cannot change the value of a predefined constant. You can use this constant to specify a key when calling a general registry-related function. This predefined constant is also supported when using the Is funtion. Used With • Is REGDB _ KEYPATH _ DOTNET _ 11 REGDB _ KEYPATH _ DOTNET _ 11 is a predefined constant whose value is the registry location (not including the root key) of the registry key for version 1.1 of the .NET Framework, that is, Software\Microsoft\NET Framework Setup\NDP\v1.1.4322\. You cannot change the value of a predefined constant. You can use this constant to specify a key when calling a general registry-related function. This predefined constant is also supported when using the Is funtion.
248page
Chapter 4: Predefined Constants REGDB _ KEYPATH _ DOTNET _ 20 186 InstallShield InstallScript Language Reference Guide Used With • Is REGDB _ KEYPATH _ DOTNET _ 20 REGDB _ KEYPATH _ DOTNET _ 20 is a predefined constant whose value is the registry location (not including the root key) of the registry key for version 2.0 of the .NET Framework, that is, Software\Microsoft\NET Framework Setup\NDP\v2.0.50215\. You cannot change the value of a predefined constant. You can use this constant to specify a key when calling a general registry-related function. This predefined constant is also supported when using the Is funtion. Used With • Is REGDB _ KEYPATH _ RUN REGDB _ KEYPATH _ RUN is a predefined constant whose value is the registry location (not including the root key) of the general application paths key, that is, Software\Microsoft\Windows\CurrentVersion\Run\. You can use this constant to specify a key when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ KEYPATH _ RUNONCE REGDB _ KEYPATH _ RUNONCE is a predefined constant whose value is the registry location (not including the root key) of the general application paths key, that is, Software\Microsoft\Windows\CurrentVersion\RunOnce\. You can use this constant to specify a key when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ KEYPATH _ RUNONCEEX REGDB _ KEYPATH _ RUNONCEEX is a predefined constant whose value is the registry location (not including the root key) of the general application paths key, that is, Software\Microsoft\Windows\CurrentVersion\RunOnceEx\. You can use this constant to specify a key when calling a general registry-related function. You cannot change the value of a predefined constant.
249page
Chapter 4: Predefined Constants REGDB _ KEYPATH _ SHAREDDLLS InstallShield InstallScript Language Reference Guide 187 REGDB _ KEYPATH _ SHAREDDLLS REGDB _ KEYPATH _ SHAREDDLLS is a predefined constant whose value is the registry location (not including the root key) of the general application paths key, that is, Software\Microsoft\Windows\CurrentVersion\SharedDLLs\. You can use this constant to specify a key when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ KEYPATH _ UNINSTALL REGDB _ KEYPATH _ UNINSTALL is a predefined constant whose value is the registry location (not including the root key) of the general uninstallation key for applications, that is, Software\Microsoft\Windows\CurrentVersion\Uninstall\. You can use this constant to specify a key when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ KEYPATH _ WINCURRVER REGDB _ KEYPATH _ WINCURRVER is a predefined constant whose value is the registry location (not including the root key) of the Windows current version key, that is, Software\Microsoft\Windows\CurrentVersion\. You can use this constant to specify a key when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ KEYPATH _ WINCURRVER _ AUTO The value of this system variable is REGDB_KEYPATH_WINCURRVER on Windows 95, Windows 95, and Windows Me, and REGDB _ KEYPATH _ WINNTCURRVER on Windows NT, Windows 2000, and Windows XP and later. REGDB _ KEYPATH _ WINNTCURRVER REGDB _ KEYPATH _ WINNTCURRVER is a predefined constant whose value is the registry location (not including the root key) of the Windows NT current version key, that is, Software\Microsoft\Windows NT\CurrentVersion\. You can use this constant to specify a key when calling a general registry-related function. You cannot change the value of a predefined constant.
250page
Chapter 4: Predefined Constants REGDB _ KEYS 188 InstallShield InstallScript Language Reference Guide REGDB _ KEYS REGDB _ KEYS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBQueryKey REGDB _ NAMES REGDB _ NAMES is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBQueryKey REGDB _ NUMBER REGDB _ NUMBER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetAppInfo • RegDBGetKeyValueEx • RegDBSetKeyValueEx • RegDBSetAppInfo REGDB _ STRING REGDB _ STRING is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetAppInfo • RegDBGetKeyValueEx
251page
Chapter 4: Predefined Constants REGDB _ STRING _ EXPAND InstallShield InstallScript Language Reference Guide 189 • RegDBSetKeyValueEx • RegDBSetAppInfo REGDB _ STRING _ EXPAND REGDB _ STRING _ EXPAND is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBSetAppInfo • RegDBGetKeyValueEx • RegDBSetKeyValueEx • RegDBGetAppInfo REGDB _ STRING _ MULTI REGDB _ STRING _ MULTI is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetAppInfo • RegDBGetKeyValueEx • RegDBSetKeyValueEx • RegDBSetAppInfo REGDB _ UNINSTALL _ COMMENTS REGDB _ UNINSTALL _ COMMENTS is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem
252page
Chapter 4: Predefined Constants REGDB _ UNINSTALL _ CONTACT 190 InstallShield InstallScript Language Reference Guide REGDB _ UNINSTALL _ CONTACT REGDB _ UNINSTALL _ CONTACT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ DISPLAYICON REGDB _ UNINSTALL _ DISPLAYICON is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ DISPLAY _ VERSION PROJECT This information applies to InstallScript projects. REGDB _ UNINSTALL _ DISPLAY _ VERSION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ HELPLINK REGDB _ UNINSTALL _ HELPLINK is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
253page
Chapter 4: Predefined Constants REGDB _ UNINSTALL _ HELPTELEPHONE InstallShield InstallScript Language Reference Guide 191 Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ HELPTELEPHONE REGDB _ UNINSTALL _ HELPTELEPHONE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ INSTALLDATE REGDB _ UNINSTALL _ INSTALLDATE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ INSTALLLOC PROJECT This information applies to InstallScript projects. REGDB _ UNINSTALL _ INSTALLLOC is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem
254page
Chapter 4: Predefined Constants REGDB _ UNINSTALL _ INSTALLSOURCE 192 InstallShield InstallScript Language Reference Guide REGDB _ UNINSTALL _ INSTALLSOURCE REGDB _ UNINSTALL _ INSTALLSOURCE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ LANGUAGE REGDB _ UNINSTALL _ LANGUAGE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ LOGFILE PROJECT This information applies to InstallScript projects. REGDB _ UNINSTALL _ LOGFILE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ MAINT _ OPTION PROJECT This information applies to InstallScript projects.
255page
Chapter 4: Predefined Constants REGDB _ UNINSTALL _ MAJOR _ VERSION InstallShield InstallScript Language Reference Guide 193 REGDB _ UNINSTALL _ MAINT _ OPTION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ MAJOR _ VERSION PROJECT This information applies to InstallScript projects. REGDB _ UNINSTALL _ MAJOR _ VERSION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ MINOR _ VERSION PROJECT This information applies to InstallScript projects. REGDB _ UNINSTALL _ MINOR _ VERSION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ MODIFYPATH REGDB _ UNINSTALL _ MODIFYPATH is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
256page
Chapter 4: Predefined Constants REGDB _ UNINSTALL _ NAME 194 InstallShield InstallScript Language Reference Guide Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ NAME REGDB _ UNINSTALL _ NAME is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ NOMODIFY REGDB _ UNINSTALL _ NOMODIFY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ NOREMOVE REGDB _ UNINSTALL _ NOREMOVE is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ NOREPAIR REGDB _ UNINSTALL _ NOREPAIR is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant.
257page
Chapter 4: Predefined Constants REGDB _ UNINSTALL _ PRODUCTGUID InstallShield InstallScript Language Reference Guide 195 Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ PRODUCTGUID PROJECT This information applies to InstallScript projects. REGDB _ UNINSTALL _ PRODUCTGUID is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ PRODUCTID REGDB _ UNINSTALL _ PRODUCTID is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ PUBLISHER REGDB _ UNINSTALL _ PUBLISHER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem
258page
Chapter 4: Predefined Constants REGDB _ UNINSTALL _ README 196 InstallShield InstallScript Language Reference Guide REGDB _ UNINSTALL _ README REGDB _ UNINSTALL _ README is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ REGCOMPANY REGDB _ UNINSTALL _ REGCOMPANY is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ REGOWNER REGDB _ UNINSTALL _ REGOWNER is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ STRING P ROJECT This information applies to InstallScript projects. REGDB _ UNINSTALL _ STRING is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions or assigned to one or more system variables. You cannot change the value of a predefined constant.
259page
Chapter 4: Predefined Constants REGDB _ UNINSTALL _ SYSTEMCOMPONENT InstallShield InstallScript Language Reference Guide 197 Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ SYSTEMCOMPONENT REGDB _ UNINSTALL _ SYSTEMCOMPONENT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ URLINFOABOUT REGDB _ UNINSTALL _ URLINFOABOUT is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ URLUPDATEINFO REGDB _ UNINSTALL _ URLUPDATEINFO is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ UNINSTALL _ VERSION P ROJECT This information applies to InstallScript projects.
260page
Chapter 4: Predefined Constants REGDB _ VALUENAME _ APPPATH 198 InstallShield InstallScript Language Reference Guide REGDB _ UNINSTALL _ VERSION is a predefined constant used to represent a value that is passed to or returned by one or more built-in functions. You cannot change the value of a predefined constant. Used With • RegDBGetItem • RegDBSetItem REGDB _ VALUENAME _ APPPATH REGDB _ VALUENAME _ APPPATH is a predefined constant whose value is the path value name under the application path key, that is, "Path". You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ APPPATHDEFAULT REGDB _ VALUENAME _ APPPATHDEFAULT is a predefined constant whose value is the default value name under the application path key, that is, a null string (""). You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ INSTALL REGDB _ VALUENAME _ INSTALL is a predefined constant whose value is "Install". You can use this constant to specify a value when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ SP REGDB _ VALUENAME _ INSTALL is a predefined constant whose value is "SP". You can use this constant to specify a value when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ COMMENTS REGDB _ VALUENAME _ UNINSTALL _ COMMENTS is a predefined constant whose value is the comments value name under the application uninstallation key— that is, Comments. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant.
261page
Chapter 4: Predefined Constants REGDB _ VALUENAME _ UNINSTALL _ CONTACT InstallShield InstallScript Language Reference Guide 199 REGDB _ VALUENAME _ UNINSTALL _ CONTACT REGDB _ VALUENAME _ UNINSTALL _ CONTACT is a predefined constant whose value is the contact value name under the application uninstallation key—that is, Contact. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ DISPLAYICON REGDB _ VALUENAME _ UNINSTALL _ DISPLAYICON is a predefined constant whose value is the display icon value name under the application uninstallation key— that is, DisplayIcon. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ DISPLAYNAME REGDB _ VALUENAME _ UNINSTALL _ DISPLAYNAME is a predefined constant whose value is the display name value name under the application uninstallation key—that is, DisplayName. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ DISPLAYVERSIO N REGDB _ VALUENAME _ UNINSTALL _ DISPLAYVERSION is a predefined constant whose value is the display version value name under the application uninstallation key—that is, DisplayVersion. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ HELPLINK REGDB _ VALUENAME _ UNINSTALL _ HELPLINK is a predefined constant whose value is the help link value name under the application uninstallation key—that is, HelpLink. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant.
262page
Chapter 4: Predefined Constants REGDB _ VALUENAME _ UNINSTALL _ HELPTELEPHONE 200 InstallShield InstallScript Language Reference Guide REGDB _ VALUENAME _ UNINSTALL _ HELPTELEPHON E REGDB _ VALUENAME _ UNINSTALL _ HELPTELEPHONE is a predefined constant whose value is the help telephone value name under the application uninstallation key—that is, HelpTelephone. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ INSTALLDATE REGDB _ VALUENAME _ UNINSTALL _ INSTALLDATE is a predefined constant whose value is the installation date value name under the application uninstallation key—that is, InstallDate. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ INSTALLLOCAT I ON REGDB _ VALUENAME _ UNINSTALL _ INSTALLLOCATION is a predefined constant whose value is the installation location value name under the application uninstallation key—that is, InstallLocation. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ INSTALLSOURC E REGDB _ VALUENAME _ UNINSTALL _ INSTALLSOURCE is a predefined constant whose value is the installation source value name under the application uninstallation key—that is, InstallSource. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a predefined constant. REGDB _ VALUENAME _ UNINSTALL _ LANGUAGE REGDB _ VALUENAME _ UNINSTALL _ LANGUAGE is a predefined constant whose value is the language value name under the application uninstallation key—that is, Language. You can use this constant to specify a value name when calling a general registry-related function. You cannot change the value of a prede