InstallShield-用户界面函数（原创+转载）

这两天遇到一个InstallShield卸载的问题，不同的计算机上有不同的现象，就是在卸载的时候，当前产品的注册表项所在的目录（还有其他产品的注册表项），都被删除了，正确的做法应该是只删除当前产品的注册表项目录就好了。最后发现是InstallShield的行为。

【LOGGING：不记录卸载信息，使信息不记录在卸载日志文件中。注意：记录功能由函数DeinstallStart自动置为有效。在调用DeinstallStart之前置记录卸载信息无效将不起任何作用，因为当DeinstallStart被调用时，记录功能将被自动激活，用户必须就在不应被记录的卸载操作执行之前手控禁止记录。】

【LOGGING：激活存入卸载记录功能。当存入功能被激活时，InstallShield存入的卸载记录的操作结果将被记录在卸载日志文件中，并将在卸载过程中被反向。自动调用DeinstallStart激活存入功能；因此，你不需要手动激活存入功能除非你先前用Disable函数禁用了它。】

所以在操作注册表前，用Disable（LOGGING），不记录卸载信息，这样InstallShield就只会按照脚本里的行为处理了。

下面的文章是转载的资料：

[转载地址] http://blog.163.com/joastonish@126/blog/static/1695160020083353142127/

1  库函数综述
InstallShield包含300多个内部库函数，用户可在安装脚本中调用它们来创建程序组，操作文件夹，处理目录，监督安装状态，创建对话框，操作文件及其它更多工作。因为InstallShield脚本编译器已经识别这些库函数名，所以用户在使用它们之前无须说明。
为了成功调用一个内部库函数，用户必须知道库函数名称及使用格式。InstallShield 库函数参阅附录D库函数索引。在接下去的几节中我们将对其中主要的一些库函数作详细介绍。在这里先简单向用户描述一下库函数的构成。
如：AskYesNo是一个库函数，它在对话框中显示一个询问，然后等待最终用户通过点击按扭来响应，Yes或No。AskYesNo格式如下： AskYesNo(szQuestion,nDefault)。这个格式显示了正确的函数名，括号中显示了函数的参数列表。在函数的详细说明帮助中，每个参数用匈牙利标记法表示，指出每个参数位置上可被接受的数值类型。AskYesNo要求两个参数：第一个是字符类型，第二个是数值型。
与C语言一样，InstallShield区分大小写，因此用户要严格注意库函数名称中大写字母。
在用户的脚本中使用任何库函数，传递的参数数目一定要正确，并且要确保传递的每个参数值符合该位置规定的类型。如果用户传递了错误的参数数目或者在任何一个或几个参数位置传递了不相符的数值类型，脚本都不能被编译。
注意:
．作为参数传递的字符串必须包括在单引号或者双引号内。
如：“Please wait while files are transferred”，或‘This is a string’或“c:\\Myfolder\\myfile.txt”
．InstallShield 不允许将一个赋值语句作为参数传递。另外，用户在一个函数变量中不能使用&&或||运算符。
．由一个调用传递给一个函数的可变长字符串变量在被调用函数中不能自变长。如果函数试图赋一个值，该值的长度超过参数的现有长度，则会发生401运行错误。为避免这个错误，在调用将字符串传递给一个函数时就要为字符串指定一个特定长度。
2  用户界面函数
用户界面函数允许用户自定义特定的错误信息及错误框标题。然而，一些在安装开发中遇到的内部错误信息是不能由用户界面函数来修改的。这部分主要对用户界面函数的语法、描述、参数等作详细说明。
2.1  Disable函数
语法：Disable(nConstant)
说明：Disable函数使由参数nConstant指定的用户界面对象或安装特性无效。
参数：
nConstant
指定用户界面对象或可操作特性使其无效，在这个参数位置传递下列预定义常量之一：
BACKBUTTON：使在一些内部对话框中显示的Back按钮无效（即使其变灰显示），Back按钮缺省置为有效。
BACKGROUND：使安装主背景窗口无效且隐藏。注意：当安装处于全屏幕方式时该参数不起作用。
BILLBOARD：在安装过程中取消布告板的显示。
DIALOGCACHE：使对话缓冲机制无效。有关对话缓冲的详细说明，请参阅Enable。
HOURGLASS：使光标由一个“忙”光标（缺省为沙漏光标）改变为标准光标（缺省为一个指针）。
INDVFILESTATUS：使路径及文件名在文件传输时不显示在进度指示器（状态条）中。
LOGGING：不记录卸载信息，使信息不记录在卸载日志文件中。注意：记录功能由函数DeinstallStart自动置为有效。在调用DeinstallStart之前置记录卸载信息无效将不起任何作用，因为当DeinstallStart被调用时，记录功能将被自动激活，用户必须就在不应被记录的卸载操作执行之前手控禁止记录。
NEXTBUTTON：使一些内部对话框的Next按钮无效（使其变灰显示）。Next按钮缺省置为有效。
SELFREGISTERBATCH：使注册自注册文件的批处理方法无效。详细说明请参阅Enable。
SATAUS：使标准进展指示器（状态条）无效且隐藏。
STATUSDLG：使对话框形式的进展指示器（状态条）无效且隐藏。
STATUSEX：禁止以显示安装状态对话框来取代进度指示器（状态条）。
STATUSOLD：使原风格的进度指示器（状态条）无效且隐藏。
返回值：
 0：说明函数成功禁止了由参数nConstant指定的用户界面对象或安装特性。
<0：说明函数未能禁止由参数nConstant指定的用户界面对象或安装特性。
注解：
·如果用户的脚本中调用Disable函数来禁用Next或Back按钮，那么在函数被调用后的所有对话框中该按钮均被禁用，为激活Next或Back按钮，用户需带相应的常量来调用Enable。
·DIALOGCACHE在没有Next 或Back按钮的对话框中不起作用。
2.2  Enable函数
语法：Enable (nConstant);
说明：Enable函数激活由参数nConstant指定的用户界面对象或安装特性。
参数：
nConstant
指定你要激活的用户界面对象或操作特性。在该参数位置传递下列预定义常量之一：
BACKBUTTON：激活显示在一些内部对话框中的Back按扭。缺省时Back按扭是被激活的，但可以通过调用Disable函数来禁用它。
BACKGROUND：当安装是在窗口方式时，显示安装主背景窗口。当安装是缺省的全屏幕方式时，该常量没有作用。为激活窗口方式，你必须以常量DEFWINDOWMODE或 FULLWINDOWMODE来调用Enable。
DEFWINDOWMODE：配置主背景窗口为一个有标题栏的标准窗口。如果背景窗口被激活，它的外观将会立即改变。如果背景窗口被禁用，屏幕不会被修改直到带常量BACKGROUND调用Enable时。
DIALOGCACHE：激活对话框缓冲机制，它可以消除在显示对话框之间出现的屏幕闪烁。这种屏幕闪烁在运行于窗口方式的安装的标题栏中特别明显。注意对话框缓冲机制仅工作于有BACK和NEXT按扭的对话框。缺省时对话框缓冲被禁用。
FULLWINDOWMODE：设置主背景窗口为一个有标题栏的最大化窗口。如果背景窗口被激活，它的外观将会立即改变。如果背景窗口被禁用，屏幕不会被修改直到带常量BACKGROUND来调用Enable时。
HOURGLASS：使光标改变为“忙”光标，缺省为一个沙漏光标。
INDVFILESTATUS：当调用ComponentTransferData、 CopyFile、 或XcopyFile并且进度指示器被激活时，激活显示每个文件的全限定名（在进度指示器的第二行中显示）。注意，在一个运行基于事件的脚本的安装程序中，ComponentTransferData被自动调用。
LOGGING：激活存入卸载记录功能。当存入功能被激活时，InstallShield存入的卸载记录的操作结果将被记录在卸载日志文件中，并将在卸载过程中被反向。自动调用DeinstallStart激活存入功能；因此，你不需要手动激活存入功能除非你先前用Disable函数禁用了它。
NEXTBUTTON：激活显示在一些内部对话框中的Next按扭。Next 按扭缺省为激活。
SELFREGISTERBATCH：激活注册自注册文件的批处理方法。该方法使用来避免和自注册文件相关联的依赖性问题。缺省为标准（非批处理）自注册。
    有关批处理方法的更多信息如下：
·在文件组窗格中，高亮显示你的自注册文件的文件组文件夹。它的属性表在打开在右边。
·双击Self-Registered域，则自注册页打开。
·选择"Yes, all the files in this file group are self-registering"单选钮。
·打开你的安装脚本（在Scripts窗格中找到Setup.rul）。
` 在你传输文件前，以SELFREGISTERBATCH选项调用Enable函数。所有自注册文件放在一个内部队列中，也就是，当它们被安装时它们会被立即注册。（在一个使用基于事件脚本的安装程序中，OnBegin处理程序被调用前，Enable(SELFREGISTERBATCH)会被自动调用。）
传输文件后，以SELFREGISTRATIONPROCESS选项调用Do函数。当你调用Do(SELFREGISTRATIONPROCESS)时，InstallShield注册所有自注册文件。如果当Do被调用时，系统变量BATCH_INSTALL等于TRUE（表明需要一个重启来完成该安装）,则注册自注册文件被延迟到重启后。
　　在你调用Do(SELFREGISTRATIONPROCESS)后，你可以检查自注册是否成功。如果因任何原因Do失败了，它会返回-1。那些自注册失败的文件的名称被保存在系统变量ERRORFILENAME中，由一个分号分隔。
例如，下列代码将所有自注册文件注册在文件媒体库中。
// Enable batch method to queue self-registering files.
Enable ( SELFREGISTERBATCH );
// Install files.
nResult = ComponentTransferData( MEDIA );
// Register the files, check for errors.
if Do ( SELFREGISTRATIONPROCESS ) < 0 then
szMsg = "File(s) failed to self-register: \n" + ERRORFILENAME;