InstallShield内部库函数

InstallShield 内部库函数

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;

MessageBox (szMsg, WARNING);

endif;

STATUS ：激活显示标准进度指示器（状态栏）。

STATUSDLG ：激活显示对话框风格的进度指示器（状态栏）。

STATUSEX ：激活显示安装状态对话框来取代进度指示器（状态栏）。

STATUSOLD ：激活显示旧风格进度指示器（状态栏），它没有一个 Cancel 按扭。

返回值：

0 ：表明函数成功激活由参数 nConstant 指定的用户界面对象或安装特性。

< 0 ：表明函数未能激活由参数 nConstant 指定的用户界面对象或安装特性。

注解：

·缺省时，安装运行在全屏方式；主背景窗口显示为一个没有标题栏的全屏窗口。这种方式中，主安装窗口不能被调整大小并且没有一个可见的标题栏。为激活窗口方式，你必须以常量 DEFWINDOWMODE 或 FULLWINDOWMODE 来调用 Enable 。

· 如果你的脚本中调用 Disable 函数来禁用 Next 或 Back 按钮，那么在函数被调用后的所有对话框中该按钮均被禁用，为激活 Next 或 Back 按钮，你需带相应的常量来调用 Enable 。

· DIALOGCACHE 在没有 Next 或 Back 按钮的对话框中不起作用。

2.3 FindWindow

语法： FindWindow (szClassName, szWinName);

说明： FindWindow 函数通过指定一个窗口的窗口类和窗口名为高级开发人员提供一个得到窗口句柄的方法。如果你知道了一个应用程序的窗口类和窗口名，就可得到它的句柄。然后你可以通过这个句柄直接发送信息给该窗口。

参数：

szClassName

指定窗口所属类的名字。若指定为"任意类"，则在该参数处传递一个空字符串。

szWinName

指定窗口标题。为返回指定类中最顶层窗口的句柄，在该参数处传递一个空字符串（""）。

返回值：

XXXX ：窗口的句柄。

NULL (0) ： FindWindow 根据指定的窗口名和类名不能找到该窗口。

注解：

·要找到一个窗口的类和名字，可运行 Microsoft Spy.exe 程序。

2.4 PlaceBitmap

语法： PlaceBitmap (szName, nID_BITMAP, nDx, nDy, nDrawOp);

说明： PlaceBitmap 函数在安装窗口中插入一个图象。图象来源由 szName 指定，它可以是一个位图文件（ .bmp ），图元文件 (.wmf) ，或者是动态链接库（ .dll ）。 InstallShield 支持 2 色、 16 色、 256 色和真彩色位图（ bitmap ）。 2 色、 16 色、 256 色位图可有透明部分。

透明位图在显示可与背景窗口组合显示的图象时有用。在位图中与指定的透明色匹配的像素不会被显示；在该位置的背景像素保持可见。在安装中，一个有技巧的设计常常用包含有公司名称和徽标的透明位图来作为安装窗口的标题。

为指定一个透明位图，你必须给参数 nDrawOp 位置传递一个常量 BITMAPICON 。你也必须考虑在一个位图中什么颜色被置为透明。缺省的透明色是 purple(RGB(255,0,255)) 。要指定一个不同的透明色，可用下面描述的参数 szName 来指定。

因为图元文件（ metafile ）是绘制的，而不是放置的，它们固有为透明。如果 BITMAPICON 被指定为一个图元文件，则该参数被忽略。

通过使用 SetDisplayEffect 函数可以显示非透明位图的许多特殊显示效果。该函数也为图元文件提供了有限的显示效果。

窗口中位图的位置可以用两种方法中的一种来指定：

·通过参数 nDrawOp 来传递位置常数。

·通过参数 nDx 与 nDy 来传递距安装窗口边缘的垂直和水平位移。

通常可通过调用 PlaceBitmap （将参数 nDrawOp 设置为 REMOVE ）来删除任何不再需要的位图文件和图元文件。建议删除不需要的位图，即使该位图可以被其他位图完全覆盖，因为第一个位图的调色板入口只有在位图被删除后才会被释放。

　　一个真彩色位图显示在一个运行于 16 色或 256 色模式的系统上时，只用那些在调色板中有效的颜色；不会给位图分配附加的颜色，即使附加调色板入口是有效的。若你希望含有 24 位位图的安装可在 16 色或 256 色的系统中运行，需要包含该位图的 16 色或 256 色的版本。然后在选择要显示的位图前带参数 COLORS 调用 GetSystemInfo 来确定当前颜色模式。

参数：

szName

指定要被显示图象的位图文件、图元文件的全限定名或动态链接。 InstallShield 通过扩展名来识别位图文件和图元文件。位图文件必须有扩展名 .bmp, 图元文件必须有扩展名 .wmf. 动态链接必须有扩展名 .dll 。如果一个文件名指定为没有扩展名， InstallShield 将假定其扩展名为 .dll 。

　　为指定一个候选透明色，在文件名后放置一个分号（；），后随一组 RGB 颜色值（ RGB 颜色由三个数值指定，由逗号分隔）。该颜色被用作由 szName 指定的位图的透明色。注意它对于已经被显示的位图不起作用，也不会成为随后调用 PlaceBitmap 而显示的位图的缺省透明色。

下面的参数指定白色为透明色：

SUPPORTDIR ^ "Bitmap.bmp;255,255,255"

当 nDrawOptions 设置为 REMOVE 时，该参数被忽略。

nID_BITMAP

指定驻留在一个 .dll 中的位图的资源 ID 。如果位图的源点是图元文件或位图文件，指定一个在当前显示的图象中没有使用的数值；所有同时显示的图象必须有其唯一的 ID 号。当 nDrawOptions 设置为 REMOVE ，该参数必须包含显示的图象的 ID 。

nDx

当 nDrawOp 设置为 LOWER_LEFT, LOWER_RIGHT, UPPER_LEFT, 或 UPPER_RIGHT 时以像素点指定安装窗口边缘和图象边缘之间的水平距离；否则该参数被忽略。

nDy

当 nDrawOp 设置为 LOWER_LEFT, LOWER_RIGHT, UPPER_LEFT, 或 UPPER_RIGHT 时以像素点指定安装窗口边缘和图象边缘之间的垂直距离；否则该参数被忽略。

nDrawOp

指定位图放置的位置，设置放置选项，或者删除先前放置的位图。给该参数传递下列预定义好的常数：

BITMAPICON ：指出位图有透明部分。用户可以用按位或运算符（｜）来将该常量和其他常量（除 TILED 、 FULLSCREEN 或 FULLSCREENSIZE 外）组合。当 BITMAPICON 和那些常量之一组合时，按位或运算被忽略，而只使用 BITMAPICON 。

TILED ：位图在主安装窗口平铺。该常量通常被用来创建一个安装背景。当该常量被指定时，即使位置选项被忽略，特殊效果已被 SetDisplaytEffect 激活，位图仍正常显示。

FULLSCREEN ：拖拉图象使其填充整个安装窗口。拖拉时图象不会被调整大小。如果一个位图图象比 InstallShield 主窗口小，它在窗口中被置中，背景由当前背景色填充。缺省值为深青色（ teal ）；可以通过使用 SetColor 函数来改变。当这个常量被指定时，位置选项被忽略，即使一个特殊效果已经被 SetDisplayEffect 激活，位图仍正常显示。

FULLSCREENSIZE ：拖拉和伸展图象使其填充满整个安装窗口。当这个常量被指定时，位置选项被忽略，即使一个特殊效果已经被 SetDisplayEffect 激活，位图仍正常显示。

CENTERED ：将位图置于 InstallShield 安装窗口的中央。

LOWER_LEFT ：将位图置于 InstallShield 安装窗口的左下角。

LOWER_RIGHT ：将位图置于 InstallShield 安装窗口的右下角。

UPPER_LEFT ：将位图置于 InstallShield 安装窗口的左上角。

UPPER_RIGHT ：将位图置于 InstallShield 安装窗口的右上角。

REMOVE ：删除一个先前放置的位图或图元。任何由 SetDisplayEffect 激活的特殊效果被忽略。

返回值：

0 ：表明函数成功找到和放置图象。

< 0 ：表明函数未能找到或放置图象。

注解：

·调用 SetDisplayEffect 来为非平铺、全屏幕、透明位图设置特殊效果；用户也可以用它为图元设置有限的特殊效果。

· InstallShield 不支持 24 位透明位图。如果用户在一个 24 位位图中包含了透明色而且指定了 BITMAPICON 常量，该颜色将被正常显示。

·当你在运行 256 色模式的系统中放置一个 256 色的位图时， InstallShield 将试图分配位图的调色板到系统调色板。如果多个 256 色位图被放置， InstallShield 将试图将所有可视位图的调色板合并到系统调色板，优先为最近放置的位图。这种行为可能导致在其他位图被显示时先前放置的位图改变颜色。

·在一个运行在有 256 色抖动背景的 256 色模式的系统中，含有许多颜色的位图可能导致一些给背景使用的调色板入口被重新分配；这可引起在背景中出现一种梯度效果。如果安装中包含了使用多种颜色的位图，则当它们运行在 256 色系统中时应不要使用 256 色抖动背景。

·系统调色板仅存在于运行在 256 色模式的系统中。运行在 windows 95 和其后高彩色或者真彩色模式下的系统及运行在 65525 （ 16 位）色模式 Windows NT 下的系统中都没有系统调色板。这些系统中不用考虑调色板句柄问题。颜色使用 RGB 值来直接显示。

·因为图元文件是被着色的，它们不包括一个自定义调色板。当一个图元文件在一个 256 色系统中显示时，不发生调色板处理；图元文件是用当前调色板中有用的颜色绘制而成。由此，若要运行在 256 色系统中，用户在安装程序中不应该使用显示颜色不同于标准 16 色的图元文件。

2.5 PlaceWindow

语法： PlaceWindow (nObject, nDx, nDy, nCorner);

说明： PlaceWindow 函数改变用户界面对象的位置，包括布告牌。用 nDx 和 nDy 指定对象的边与屏幕边缘的距离。

参数：

nObject

指定要被改变位置的对象。在该参数位置传递下列预定义的常量之一：

BACKGROUND ：移动背景窗口。

BILLBOARD ：设置在文件传输过程中使用的布告牌的位置。

MMEDIA_AVI ：设置要播放的下一个 AVI 文件的窗口位置。缺省时， AVI 文件将在 InstallShield 客户窗口的左边位置窗口中播放，从左起 10 个像素点，从上起 10 个像素点。

STATUS ：移动进度指示器。

STATUSDLG ：移动对话框风格的进度指示器。

STATUSEX ：移动安装状态对话框。

STATUSOLD ：移动旧风格的进度指示器。

当你调用 PlaceWindow 来移动进度指示器或者状态对话框时，确信为你在安装中激活的反馈对象传递了正确常量。例如，如果你调用了 Enable(STATUSOLD), 则你必须传递 STATUSOLD 给 PlaceWindow 。

nDx

以像素点指定对象的边与屏幕边缘之间的水平距离。

nDy

以像素点指定对象的边与屏幕边缘之间的垂直距离。

nCorner

指定用 nDx 和 nDy 表示的距离是从哪个角度量所得。在该参数位置传递下列预定义的常量之一：

LOWER_LEFT ：从 InstallShield 主窗口的左边度量得 nDx ，从底端度量得 nDy 。

LOWER_RIGHT ：从 InstallShield 主窗口的右边度量得 nDx ，从底端度量得 nDy 。

UPPER_LEFT ：从 InstallShield 主窗口的左边度量得 nDx ，从顶端度量得 nDy 。

UPPER_RIGHT ：从 InstallShield 主窗口的右边度量得 nDx ，从顶端度量得 nDy 。

返回值：

0 ：表明函数成功改变了对象的位置。

< 0 ：表明函数未能改变对象的位置。

注解：

·使用该函数时要意识到一个安装程序要运行在不同的屏幕分辨率下。你在放置对象前可能要确定屏幕范围。距离以像素点度量，是对象边缘与指定的屏幕角落边缘之间的距离。

·用户不能用该函数定位消息框，因为消息框是由本机的 Windows/PM API 创建。一个消息框的位置由 Windows/PM 确定，而不是在 InstallShield 控制之下。另外，用户不能用该函数定位一个自定义对话框。

2.6 PlayMMedia

语法： PlayMMedia (nType, szFileName, nOperation, nReserved);

说明： PlayMMedia 函数播放一个声音或 AVI 文件。 MIDI 或 WAVE 类型的声音文件和 AVI( 视频 ) 文件既可以以同步方式也可以以异步方式播放。该函数也可以被用来连续播放一个文件。为了实现这个目的，一个标志可被按位或，来指示该文件以连续方式被播放。

由于 AVI 文件早被压缩而且往往大于 1.4MB 的软盘，因此 , 视频显示推荐于光盘安装。

参数：

nType

指定文件类型。在该参数位置传递下列预定义的常量之一：

MMEDIA_WAVE ：文件是 WAVE 声音格式。

MMEDIA_MIDI ：文件是 MIDI 声音格式。

MMEDIA_AVI ：文件是一个 AVI 文件。

szFileName

指定要播放的声音 /AVI 文件的全限定名。

nOperation

指定播放方式。在该参数位置传递下列预定义的常量：

MMEDIA_PLAYSYNCH ：同步播放。

MMEDIA_PLAYASYNCH ：异步播放。该常量可以用或运算符（ | ）与 MMEDIA_PLAYCONTINUOUS 组合使用。

MMEDIA_PLAYCONTINUOUS ：连续循环播放。当以同步方式播放一个声音 /AVI 文件时不能使用该值。它只使用于以异步方式播放的文件。用或运算符（ | ）将它与 MMEDIA_PLAYASYNCH 组合使用。

MMEDIA_STOP ：停止播放。

nReserved

给该参数传递 0 值，不允许其他值。

返回值：

0 ：表明函数成功播放文件。

< 0 ：表明函数不能播放文件。

2.7 RGB

语法： RGB (constRed, constGreen, constBlue);

说明： RGB 函数创建一个自定义颜色值，该颜色可被 SetColor 和 SetTitle 使用。

参数：

constRed

指定一个数值型常数，值域为 0..255 ，指示在自定义色中红色的数量。

constGreen

指定一个数值型常数，值域为 0..255 ，指示在自定义色中绿色的数量。

constBlue

指定一个数值型常数，值域为 0..255 ，指示在自定义色中蓝色的数量。

返回值：

该函数返回一个调用 SetColor 和 SetTitle 时可被使用的自定义颜色的数值。

2.8 SetColor

语法： SetColor (nObject, nColor);

说明： SetColor 函数设置主安装窗口的背景色。

参数：

nObject

指定要改变的用户界面对象。在该参数位置传递下列预定义的常量：

BACKGROUND

指示安装窗口的背景。缺省颜色为纯深青色（ solid teal ）： RGB(0,128,128) 。

nColor

为背景指定一种颜色。

对于一种过渡背景色，可传递下列常量之一：

BK_BLUE 、 BK_GREEN 、 BK_MAGENTA 、 BK_ORANGE

BK_PINK 、 BK_RED 、 BK_YELLOW

对于一种纯背景色，可传递下列常量之一：

BK_SOLIDBLACK 、 BK_SOLIDBLUE 、 BK_SOLIDGREEN 、 BK_SOLIDMAGENTA

BK_SOLIDORANGE 、 BK_SOLIDPINK 、 BK_SOLIDRED 、 BK_SOLIDWHITE

BK_SOLIDYELLOW

对于一种自定义颜色，可在该参数位置传递 RGB 函数。

为了在使用自定义颜色绘制背景时得到光滑的效果（过渡），可将该颜色与预定义常量 BK_SMOOTH 按位或。注意当 256 色有效时光滑效果将更好。

返回值：

0 ：表明函数成功设置对象的颜色。

< 0 ：表明函数未能设置用户界面对象的颜色。

注解：

·当使用一个 RGB 值时，你可以应用 Microsoft Windows 的编程指南中描述的相同的方法。

你可以指定 RED 、 GREEN 、 BLUE 颜色的混合来"混合"颜色。用从 0 到 255 的数之一来表示使用颜色的数量。在 RGB 宏中的参数必须使用字面数值。你可以使用一个表示 RGB 颜色的长整型数来代替 RGB 语句。

2.9 SetDialogTitle

语法： SetDialogTitle (nDialogId, szTitle);

说明： SetDialogTitle 函数改变显示在一些公用内部对话框标题栏的标题。用参数 nDialogId 指定对话框。如果你不使用 SetDialogTitle ， InstallShield 显示缺省标题。一旦你为某一特定对话框设置了标题，除非你再次使用 SetDialogTitle 改变标题，否则 InstallShield 在每一个该类型对话框的实例中都使用该标题。

参数：

nDialogId

标识标题要被改变的内部对话框。在该参数位置传递下列预定义常量之一：

DLG_ASK_OPTIONS ：改变 AskOptions 对话框标题。

DLG_ASK_PATH ：改变 AskPath 对话框标题。

DLG_ASK_TEXT ：改变 AskText 对话框标题。

DLG_ASK_YESNO ：改变 AskYesNo 对话框标题。

DLG_ENTER_DISK ：改变 EnterDisk 对话框标题。

DLG_MSG_INFORMATION ：改变信息风格的消息框的标题。

DLG_MSG_SEVERE ：改变严重警告风格的消息框的标题。

DLG_STATUS ：改变对话风格进度指示器的标题。在带 DLG_STATUS 选项调用 SetDialogTitle 后，为了使标题修改有效，你必须通过调用 Enable(STATUSDLG) 来重新激活该对话风格进度指示器。

DLG_MSG_WARNING ：改变警告风格的消息框的标题。

DLG_USER_CAPTION ：当你使用用户定义的消息框风格时改变消息框的标题。

szTitle

指定新标题。

返回值：

0 ：表明函数成功修改了对话框标题。

< 0 ：表明函数未能修改对话框标题。

注解：

·你必须为每种你希望修改其标题的对话框分别调用 SetDialogTitle 。

· InstallShield 使用标准 Windows 消息框函数创建消息框。 Windows 为这些消息框确定 Ok 和 Cancel 按扭文字。 InstallShield 不能控制在 Windows 消息框中使用的按扭文字。

2.10 SetDisplayEffect

语法： SetDisplayEffect (nEffect);

说明： SetDisplayEffect 函数指定用 PlaceBitmap 函数显示位图文件或图元文件时使用的显示效果。一旦显示效果被设定，所有随后由 PlaceBitmap 显示的位图文件将一直使用该效果显示，直到另一个对 SetDisplayEffect 的调用来设定一个新的显示效果。

参数：

nEffect

指定一个显示效果。在该参数位置传递下列预定义的常量之一。注意这些常量具有互斥性；它们相互之间不能使用按位或。而且，当用 PlaceBitmap 显示一个位图文件时指定了 BITMAPICON 、 FULLSCREEN 、 FULLSCREENSIZE 或 TILED 时该参数无效：

EFF_FADE ：位图或布告牌淡入淡出。

EFF_REVEAL ：位图或布告牌逐渐从中央向四周填充。

EFF_HORZREVEAL ：位图或布告牌从它的中央逐渐水平滚动出来。

EFF_HORZSTRIPE ：位图或布告牌的一部分从外往里水平填充，然后剩余部分从中央部分往外填充。

EFF_VERTSTRIPE ：位图或布告牌的一部分从外往里垂直填充，然后剩余部分从中央部分往外填充。

EFF_BOXSTRIPE ：位图或布告牌的一部分从四周向里填充，剩余部分向四周填充。

EFF_NONE ：该选项是缺省设置。使用它来清除调用其它任一选项后的显示效果。

只有 EFF_REVEAL 和 EFF_HORZREVEAL 可用于图元文件。

返回值：

0 ：表明函数成功设置显示效果。

< 0 ：表明函数未能设置显示效果。

注解：

·当位图是由 PlaceBitmap 带选项 BITMAPICON 、 FULLSCREEN 、 FULLSCREENSIZE 或 TILED 显示时，该位图不会按显示效果显示，而是正常显示。更多的信息可查阅 PlaceBitmap 。

·显示效果仅当放置位图时出现，当删除位图时不能使用显示效果。

·只有展示（ EFF_REVEAL ）和水平展示（ EFF_HORZREVEAL ）效果可用于图元文件。

2.11 SetErrorMsg

语法： SetErrorMsg (nErrorID, szText);

说明： SetErrorMsg 函数定制 InstallShield 缺省错误信息。你可以使用该函数来指定显示这些错误信息的消息框的标题文本。

参数：

nErrorID

指定要替换的错误信息。在该参数位置传递下列预定义的常量之一：

ERR_BOX_BADPATH ：当 EnterDisk 检测到一个由用户输入的错误路径时显示该信息。

ERR_BOX_BADTAGFILE ：当 EnterDisk 检测到指定的标签文件不存在于磁盘上时显示该信息。

ERR_BOX_DISKID ：当 EnterDisk 检测到由用户指定的驱动器不存在时显示该信息。

ERR_BOX_DRIVEOPEN ：当 EnterDisk 检测到磁盘驱动器未关闭时显示该信息。

szText

指定要在消息框中显示的错误信息。

返回值：

0 ：表明函数成功改变错误信息。

< 0 ：

表明函数未能改变错误信息。

2.12 SetErrorTitle

语法： SetErrorTitle (nErrorID, szText);

说明： SerErrorTitle 函数指定 InstallShield 内部错误消息框标题栏的自定义文本。你可以使用该函数来自定义错误消息文本。

参数：

nErrorID

指定标题要被替换的错误消息框。在该参数位置传递下列预定义的常量之一：

ERR_BOX_BADPATH ：当 EnterDisk 检测到错误路径时显示该消息。

ERR_BOX_BADTAGFILE ：当 EnterDisk 检测到指定的标签文件不存在于磁盘上时显示该消息。

ERR_BOX_DISKID ：当 EnterDisk 检测到指定的驱动器不存在时显示该消息。

ERR_BOX_DRIVEOPEN ：当 EnterDisk 检测到磁盘驱动器未关闭时显示该消息。

szText

指定显示在错误消息框中的标题。

返回值：

0 ：表明函数成功修改了标题栏的文本。

< 0 ：表明函数未能修改标题栏的文本。

2.13 SetFont

语法： SetFont (nItemID, nFontStyle, szFontName);

说明： SetFont 函数设置显示的正文串的字体和风格。你可以在该函数使用标准 Windows

字体。

参数：

nItemID

指定其字体和字体风格要被设置的项。在该参数位置传递下列预定义的常量：

FONT_TITLE ：指定安装过程的主标题，该主标题显示在安装窗口的左上角。

nFontStyle

指定字体风格。在该参数位置传递下列预定义的一个或多个常量。除 STYLE_NORMAL 之外的所有常量可以用按位或来指定多种风格：

STYLE_NORMAL ：没有加粗、倾斜或阴影（不能被按位或）。

STYLE_BOLD ：字体加粗。

STYLE_ITALIC ：字体倾斜。

STYLE_SHADOW ：字体有阴影底纹。

STYLE_UNDERLINE ：加下划线。

szFontName

指定一个有效的 Windows 字体的名称。有效的字体名称包括 Courier, Helv, Helvetica, Modern, Roman, Script, Terminal, Times 和 TmsRmn 。如果指定的字体没有找到指定的风格，就使用 Arial 。

返回值：

0 ：表明函数成功设置字体。

< 0 ：表明函数未能设置字体。

2.14 SetStatusWindow

语法： SetStatusWindow (nPercent, szString);

说明： SetStatusWindows 函数为进度指示器（状态条）设置完成指示器的百分比的初始值或当前值，并指定在进度指示器（状态条）最高行显示的当前消息。

　　通过调用 ComponentTransferData 或 ComponentMoveData 来传输文件的安装必须在文件传输开始之前调用 SetStatusWindows ，这是为了设置完成指示器百分比为 0% 而且清除指示器最高行。不再需要另外调用 SetStatusWindows 。每一个组件的文件被装入时，该组件的 '状态文本'字符串会在状态条最高行自动显示。

　　使用 CopyeFile 或 XcopyFile 函数装入文件的安装程序在相继调用 CopyFile 或 XcopyFile 之间，可能需要多次调用 SetStatusWindows 来改变指示器最高行的信息。

　　在传输文件前，你的安装程序还应该调用 StatusUpdate 函数激活文件传输过程中百分比完成指示器的自动更新。为了使得在状态条第二行显示正被安装文件的名称和路径，需在传输文件前带参数 INDVFILESTATUS 来调用 Enable 函数。在这些调用后，百分比完成指示器在文件传输过程中被平滑更新，每个文件的文件名在被传输时将显示。

参数：

nPercent

指定 0 到 100 之间的一个数值来表示百分比完成指示器显示的百分比。若要改变显示在状态条最高行的信息而不改变百分比完成指示器，则指定该参数为 -1 。

szString

指定显示在状态条最高行的字符串。注意如果一个 'DisplayText' 参数已被指定给该组件（在 IDE 中），那么当调用 ComponentTransferData 时该字符串将自动改写任何该参数指定的文本。

返回值：该函数没有返回值。

2.15 SetTitle

语法： SetTitle (szTitle, nPointSize, nColor);

说明： SetTitle 函数根据 nColor 的值在主窗口标题栏或在主窗口内显示一个标题。

参数：

szTitle

指定在主窗口标题栏或主窗口内显示的一个标题。如果标题要显示在窗口的标题栏，你必须在第三个参数位置指定预定义常量 BACKGROUNDCAPTION 。如果一个标题栏的标题不符合可用空间，那将被从右截尾并以省略号终止。缺省标题栏标题为"安装"。

当给第三个参数传递一个颜色值时，标题在主窗口的顶端左对齐显示。相对主窗口太宽的标题将被从右截尾显示。为创建一个占据多行的标题，可在你希望的行断开处嵌入换行符。

nPointSize

以点数来指定一个在主窗口显示的标题的字号。建议字号为 24 点数。注意当第三个参数为 BACKGROUNDCAPTION 时该参数被忽略。

nColor

指定一个颜色或预定义常量 BACKGROUNDCAPION 。为指示 szTitle 值应该在主窗口标题栏显示，则在该参数位置传递预定义的常量 BACKGROUNDCAPTION 。当用户指定了 BACKGROUNDCAPTION ， nPointSize 被忽略；标题栏标题的颜色和字号将由最终用户的系统设置决定。注意该选项在不运行在窗口模式的安装程序中无效；请查看下面的注解。

为指示 szTitle 值应该在主窗口中显示，通过在该参数位置传递下列预定义的常量之一来指定该标题的颜色： BLACK ， BLUE ， GREEN ， MAGENTA ， RED ， YELLOW 或 WHITE 。用户也可以在该参数位置传递 RGB 函数来指定自定义颜色，如下面例子所示：

SetTitle("FantasticApp", 24, RGB(78, 125, 161));

返回值：

0 ：表明函数成功设置安装的标题。

< 0 ：表明函数未能设置安装的标题。

注解：

·不运行于窗口模式下的安装中，第三个参数设置为 BACKGROUNDCAPTION 时调用 SetTitle 无效。为在一个标准窗口中运行安装程序，你必须首先以参数 DEFWINDOWMODE 或 FULLWINDOWMODE 来调用 Enable ，然后以参数 BACKGROUND 调用 Enable 来显示窗口。

·用 SetColor 来设置你安装的背景色。

·用 SetFont 来设置在背景窗口中显示的标题的字体和字体风格。

2.16 SizeWindow

语法： SizeWindow (nObject, nDx, nDy);

说明：使用 SizeWindow 函数来改变一个特定用户界面元件的大小。以像素点来指定新的

大小。

参数：

nObject

指定要调整大小的对象。在该参数位置传递下列预定义的常量之一：

BACKGROUND ：标识为主背景窗口。

METAFILE ：标识为在文件传输过程中使用的布告牌。 SizeWindow 不支持位图文件（ .bmp ）。该参数对用 SdBitmap 函数显示的图元文件不起任何作用。 SdBitmap 自动调整被显示的图元文件的大小。

MMEDIA_AVI ：设置播放下一个 AVI 文件的窗口的大小。所有 AVI 视频以一个缺省大小来显示。改变大小可能会改变视频的有效分辨率和明快度。

nDx

以像素点指定对象的水平大小。

nDy

以像素点指定对象的垂直大小。

返回值：

0 ：表明函数成功调整窗口大小。

< 0 ：表明函数未能调整窗口大小。

注解：

·安装程序可能运行于多个不同的屏幕分辨率下。因此，你需要使用 GetExtents 函数来确定屏幕的全屏大小，然后在你的 SizeWindows 函数调用中参数使用比率来指定用户界面对象的大小。

·该函数仅推荐给高级开发人员。

2.17 StatusUpdate

语法： StatusUpdate (bLink, nFinalPercent);

说明： StatusUpdate 函数激活或禁用文件传输操作和状态条进度指示器之间的连接。当 bLink 是 ON ，连接被激活并且 nFinalPercent 指示一个在下一个文件传输结束时显示的最后百分比。在文件传输过程中，状态条平滑地从它的当前值更新到由 nFinalPercent 指定的值。当 bLink 是 OFF ，连接被禁用并且状态条的进度指示器在随后的文件传输中不会被自动更新。

如果文件传输中状态条被激活，则在每次调用 CopyFile 或 XcopyFile 之前调用 StatusUpdate 。在调用 ComponentTransferData 传输文件之前，带参数为 ON 和 100 来调用 StatusUpdate ；这将使状态条在安装的文件传输阶段平滑更新到 100% 。注意在一个运行基于事件脚本的安装中， ComponentTransferData 被自动调用。

参数：

bLink

指定是否激活或禁用文件传输操作和状态条进度指示器之间的连接。在该参数位置传递下列预定义常量之一：

ON ：指定状态条的进度指示器必须和文件传输操作相连接。

OFF ：指定禁用状态条的进度指示器和文件传输操作之间的连接。连接保持为禁用直到它通过一个随后对 StatusUpdate 带参数 bLink 为 ON 的调用而得到重新建立。

状态条可以通过调用 SetStatusWindow 而被手动更新。

nFinalPercent

指定当 bLink 为 ON 时，状态条的进度指示器在下一个文件传输操作结束时必须达到的最后百分比。如果传递给 nFinalPercent 的值小于状态条的进度指示器的当前值，则进度指示器不会改变。当 bLink 为 OFF 时，该参数被忽略。

返回值：

0 ：表明函数成功。

< 0 ：表明函数不成功。

注解：

·该函数通过计算由任何文件传输函数传递的总的字节数来工作。然后它计算从进度指示器的当前位置开始到 nFinalPercent 中的最大值，需每隔多久增加一次进度指示器。

· StatusUpdate 函数不能和 VerUpdateFile 、 VerSearchAndUpdateFile 一起工作。当调用那些函数时，你必须禁用状态条或手动更新它。

·为设置状态条到一个初始百分比，在调用 StatusUpdate 之前调用 SetStatusWindow 。

3 信息函数

下列信息函数提供操作环境中有效资源的数据：磁盘空间，内存和操作模式：

GetDiskSpace

返回指定磁盘的有效字节数（未使用的）（最高为 2GB ）。

GetDiskSpaceEx

以 bytes 、 kilebytes 、 megabytes 或 gigabytes 为单位返回一个磁盘的空闲空间，。

GetEnvVar

返回一个环境变量的当前值。

GetExtents

返回屏幕大小。

GetMemFree

返回运行在 Microsoft Windows 下的一个应用程序的可用内存。

GetSystemInfo

检索系统信息。

GetValidDrivesList

返回目标系统中所有有效驱动器。

GetWindowHandle

返回主安装窗口的句柄。

提供文件和路径检查服务，查找一个数学协处理器，检测 Windows NT 下的管理状态，确定 Microsoft Windows 是否从网络的共享版本运行。

3.1 GetDiskSpace

语法： GetDiskSpace (szDrive);

说明： GetDiskSpace 函数返回指定驱动器上的空闲磁盘空间。

参数：

szDrive

指定一个驱动器指示符（驱动器字符后随一个冒号）。你也可在该参数位置指定一个通用导航计算机路径。

返回值：

XXXX ：在指定驱动器上的空闲字节数。最大的返回值是 2GB 。超过 2GB 的空闲空间也返回 2GB 。当你需要检测超过 2GB 的空闲空间时需调用 GetDiskSpaceEx 。

< 0 ：表明 GetDiskSpace 未能获得空闲磁盘空间值。

3.2 GetDiskSpaceEx

语法： GetDiskSpaceEx (szDrive, nUnits);

说明： GetDiskSpaceEx 函数返回指定驱动器的空闲磁盘空间值。传递给 nUnits 的值确定 GetDiskSpaceEx 的返回值是以 bytes 、 kilobytes 、 megabytes 或 gigabytes 度量。

参数：

szDrive

指定一个驱动器指示符（驱动器字符后随一个冒号）。用户也可在该参数位置指定一个通用导航计算机 (UNC) 路径。

nUnits

传递下列预定义常量之一来指明度量单位：

BYTES ：指明 GetDiskSpaceEx 须返回空闲 byte 数。

KBYTES ：指明 GetDiskSpaceEx 须返回空闲 kilobyte 数。

MBYTES ：指明 GetDiskSpaceEx 须返回空闲 megabyte 数。

GBYTES ：指明 GetDiskSpaceEx 须返回空闲 gigabyte 数。

返回值：

XXXX ：在指定驱动器上的空闲 bytes 、 kilobytes 、 megabytes 或 gigabytes 数，度量单位视 nUnits 值而定。

< 0 ：表明 GetDiskSpaceEx 未能获得空闲磁盘空间值。

3.3 GetEnvVar

语法： GetEnvVar (szParameter, svValue);

说明： GetEnvVar 函数检索一个环境变量的当前值。

参数：

szParameter

指定其值要被检索的环境变量的名称。

svValue

返回该环境变量的当前值。

返回值：

0 ：表明函数检索到环境变量的值。

< 0 ：表明函数未能检索到环境变量的值。

注解：

· InstallShield 没有提供一个改变一个环境变量值的机制。在 Microsoft Windows 3.x 和 95 环境中，建议用户不要改变环境变量值。如果用户需要设置一个新的环境变量，在 Autoexec.bat 文件中设置然后重启系统。对于 Windows NT ，查看如何在 Windows NT 下设置环境变量。

3.4 GetExtents

语法： GetExtents (nvDx, nvDy);

说明： GetExtents 函数检索屏幕大小。屏幕宽以像素点为单位返回给 nvDx ，高以像素点为单位返回给 nvDy 。如：一个标准的 VGA 监控器返回 nvDx 为 640 ， nvDy 为 480 。

参数：

nvDx

以像素点为单位返回屏幕的宽。

nvDy

以像素点为单位返回屏幕的高。

返回值：

0 ：表明函数成功检索到屏幕的大小。

< 0 ：表明函数未能检索到这些值。

3.5 GetMemFree

语法： GetMemFree ( );

说明： GetMemFree 函数返回运行在 Microsoft Windows 下的一个应用程序可用的内存大小。因为 Microsoft Windows 是一个虚拟内存系统，该函数不会返回实际物理内存（称为 RAM ）而是 Windows 应用程序可用的内存。要确定目标系统上可用的实际物理内存大小，可调用 GetSystemInfo 。

参数：

GetMemFree 不带参数。以空参数表调用函数，如下所示：

GetMemFree();

返回值：

XXXX ： XXXX 是应用程序可用的空闲内存的字节数。

< 0 ： GetMemFree 未能返回空闲内存的大小。

注解：

·脚本每执行一个函数， InstallShield 返回一个数值来指示函数运行结果。如果你要在该脚本后面部分要用到该函数的返回值，则将该值赋给一个数值型变量。

3.6 GetSystemInfo

语法： GetSystemInfo (nItem, nvResult, svResult);

说明： GetSystemInfo 函数检索目标系统的信息。

参数：

第一个参数， nItem ，用来指定要检索的信息的类型。参照下面这个你可传递给该参数的常量列表来检索系统信息。注意使用特定的常量时（如 DISK_TOTALSPACE_EX ），你必须在调用该函数前为参数 nvResult 和 / 或 svResult 指定附加信息。

系统信息返回给 nvResult 和 / 或 svResult 。数值型数据返回给 nvResult 。字符串型数据返回给 svResult 。下表列出了你可以传递给 nItem 的各个常量的返回值类型。

--------------------------------------------------------------------------------

nItem ： BOOTUPDRIVE

nvResult ：启动驱动器的 ID ， 1=A ：， 2=B ：， 3=C ：。可以通过给该数值加上 64 （十进制）将该数字转换为相应的驱动器字符，然后给该值设置一个字符串变量。使用下面的语法进行转换：

svResult[0]=64+nvResult;

svResult ：返回启动驱动器的驱动器指示符（驱动器字符后随一个冒号）。

--------------------------------------------------------------------------------

nItem ： CDROM

nvResult ： TRUE 或 FALSE 指示 CD ROM 是否可用。

SvResult ： N/A

--------------------------------------------------------------------------------

nItem ： COLORS

nvResult ：返回用户系统可用颜色数目。结果从对目标系统的视频驱动器检索而得，而不是从视频卡得到。如果该卡支持 256 色但驱动器只能处理 16 色，返回的颜色值是 16 。

svResult: ： N/A

--------------------------------------------------------------------------------

nItem ： CPU

nvResult ：返回下列常量之一：

IS_UNKNOWN 用户 CPU 未知。

IS_386 用户有一个 386 处理器。

IS_486 用户有一个 486 处理器。

IS_PENTIUM 用户有一个 PENTIUM 处理器。

IS_ALPHA 用户有一个 ALPHA 处理器。

SvResult ： N/A

--------------------------------------------------------------------------------

nItem ： DATE

nvResult ： N/A

svResult ： svResult: 当前系统时间格式为 MM-DD-YYYY 。在月和日域的首零被删除。

--------------------------------------------------------------------------------

nItem ： DISK_TOTALSPACE

nvResult: ：返回由 svResult 指定的磁盘驱动器的总容量。最大返回值为 2GB 。总容量大于 2GB 的仍返回 2GB 。

SvResult ：驱动器字符。注意该参数是传递给该函数的；也就是说，你必须在调用 GetSystemInfo 前给 svResult 赋值。还要注意你必须在驱动器字符后加上冒号；否则函数执行会失败。你也可以在该参数位置指定一个通用导航计算机（ UNC ）路径。

--------------------------------------------------------------------------------

nItem ： DISK_TOTALSPACE_EX

nvResult ：指定度量单位；在该参数位置传递下列预定义的常量之一： BYTES, KBYTES, MBYTES 或 GBYTES 。在 svResult 返回指定磁盘驱动器的总容量。

SvResult ：驱动器字符。注意该参数是传递给该函数的；也就是说，用户必须在调用 GetSystemInfo 前给 svResult 赋值。还要注意必须在驱动器字符后加上冒号；否则函数执行会失败。用户也可以在该参数位置指定一个通用导航计算机（ UNC ）路径。

--------------------------------------------------------------------------------

nItem ： DRIVE

nvResult: ：在 svResult 返回指定驱动器的类型。将返回下列常量之一：

IS_UNKNOWN - 目标驱动器未知。

IS_REMOVABLE - 目标驱动器是软盘驱动器。

IS_FIXED - 目标驱动器是硬盘驱动器。

IS_CDROM - 目标驱动器是光盘驱动器。

IS_REMOTE - 目标驱动器是一网络驱动器。

SvResult ：驱动器字符后随冒号。注意该参数是传递给该函数的；也就是说，用户必须在调用 GetSystemInfo 前给 svResult 赋值。用户也可以在该参数位置指定一个通用导航计算机（ UNC ）路径。

--------------------------------------------------------------------------------

nItem ： EXTENDEDMEMORY

nvResult ： NvResult: 返回安装在机器上的内存大小。由于操作系统的限制，返回值可能会和安装在机器上的实际物理内存大小稍有差异。该值通常比实际值小 100K 。注意返回值以 kb 来度量。

SvResult ： N/A

--------------------------------------------------------------------------------

nItem ： LANGUAGE

nvResult ： nvResult: 该参数返回目标系统的 InstallShield 语言常量。返回的常量可以用来确定使用 ComponentFilterLanguage 函数的安装中装入哪些语言专用文件组。

For information about determining the default language of the target system, click here.

InstallShield International 支持 21 种语言， Windows 支持 100 多种语言。如果你想根据 nvResult 值筛选文件组，则必须使用一个开关语句根据该函数的返回常量来确定要使用的 InstallShield 语言标识号常量。带该参数时该函数的性能高度依赖于系统。

SvResult ：该参数返回和 nvResutl 返回的语言常量等价的语言名称字符串。

--------------------------------------------------------------------------------

nItem ： OS

nvResult ：返回目标操作系统平台。返回下列常量之一：

IS_WINDOWSNT - 操作系统是 Windows NT 。

IS_WINDOWS9X - 操作系统是 Windows 95 或 Windows 98 。为确定是哪个，带 WINMINOR 调用 GetSystemInfo 来检测监控器版本。如果小于 10 ，则操作系统是 Windows 95 ；否则是 Windows 98 。

SvResult ： N/A

--------------------------------------------------------------------------------

nItem ： PARALLEL

nvResult ：返回有效的物理并行口数目。

SvResult ： N/A

--------------------------------------------------------------------------------

nItem ： SERIAL

nvResult ：返回有效的物理串行口数目。

SvResult ： N/A

--------------------------------------------------------------------------------

nItem ： TIME

nvResult ： N/A

svResult ：以 HH:MM:SS 格式返回当前系统时间。

--------------------------------------------------------------------------------

nItem ： VIDEO

nvResult ： nvResult: 返回安装的视频适配器类型。（ InstallShield 不能检测 CGA 或单色视频驱动器）。返回下列常量之一：

IS_UNKNOWN - 未知的用户视频适配器。

IS_EGA - EEGA 分辨率。

IS_VGA - VGA 分辨率。

IS_SVGA - SVGA （ 800 × 600 ）分辨率。

IS_XVGA - XVGA （ 1024 × 768 ）分辨率。

IS_UVGA - 大于 1024 × 768 分辨率。

SvResult ： N/A

--------------------------------------------------------------------------------

nItem ： VOLUMELABEL

nvResult ： N/A

svResult ：传递你要检索其卷标号的驱动器的驱动器指示符（驱动器字符后随冒号）。该参数返回指定的驱动器的卷标号。如果该驱动器没有卷标号，返回空字符串。

--------------------------------------------------------------------------------

nItem ： WINMAJOR

nvResult ：返回 Windows 的主版本号。

SvResult ：以 ##.### 格式返回一个字符串，指明 Windows 的主、次版本号。

--------------------------------------------------------------------------------

nItem ： WINMINOR

nvResult ：返回 Windows 的次版本号。

SvResult ：以 ##.### 格式返回一个字符串，指明 Windows 的主、次版本号。

--------------------------------------------------------------------------------

返回值：

0 ：表明函数成功返回指定信息。

< 0 ：表明函数未能返回指定信息。

3.7 GetValidDrivesList

语法： GetValidDrivesList (listID, nDriveType, nMinDriveSpace);

说明： GetValidDrivesList 函数检索目标系统的符合特定条件的所有驱动器列表。这个条件包括驱动器类型和驱动器的最小空间数。如果一个驱动器未关闭，该驱动器名仍加入列表。

你可以在驱动器罗列之前指定要查找的驱动器的类型（ nDriveType ）和可用的最小磁盘空间（ nMinDriveSpace ）。

参数：

listID

返回有效驱动器字符的一个列表。由 listID 标识的字符串列表必须通过对 ListCreat 的调用已被初始化。

nDriveType

指定要查找的驱动器的类型。在该参数位置传递下列预定义的常量之一：

-1 ：查找所有驱动器类型。

FIXED_DRIVE ：仅查找硬盘驱动器。

REMOTE_DRIVE ：仅查找远程驱动器。远程驱动器通常位于网络。

REMOVEABLE_DRIVE ：仅查找可卸式驱动器。软盘驱动器是可卸式驱动器。

CDROM_DRIVE ：仅查找光盘驱动器。

nMinDriveSpace

指定包括在返回列表中的驱动器所必须有的最小的空闲磁盘空间的字节数。如果 nMinDriveSpace 小于 0 ， GetValidDrivesList 将不检测驱动器的最小空间。这对软盘驱动器有用。

返回值：

0 ：函数成功检索所要求的列表。

< 0 ：函数未能检索到要求的序列。

注解：

·网络映射驱动器也可作为远程驱动器返回。该函数不会返回所有网络上的驱动器，仅返回那些标识为映射驱动器的驱动器。

3.8 GetWindowHandle

语法： GetWindowHandle (nHwndFlag);

说明： GetWindowHandle 函数得到安装主窗口的句柄。

参数：

nHwndFlag

指定 InstallShield 主窗口的窗口句柄。在该参数位置传递预定义的常量 HWND_INSTALL 。

返回值：

X ： X 是窗口句柄。

< 0 ：函数未能检索到句柄。

3.9 Is

语法： Is (nIsFlag, szIsData);

说明： Is 函数检索脚本中需要的公用信息。

参数：

nIsFlag

指定要检索的信息类型。在该参数位置传递下列预定义的常量之一：

DIR_WRITEABLE ：能否写到由 szIsData 指定的目录？

FILE_EXISTS ：由 szIsData 指定的文件是否存在？

FILE_LOCKED ：文件是否锁定？

FILE_WRITEABLE ：能否写到由 szIsData 指定的文件？

MATH_COPROCESSOR ：在目标系统是否存在一个数学协处理器？

PATH_EXISTS ：由 szIsData 指定的路径是否存在？

USER_ADMINISTRATOR ：当目标操作系统是 Windows NT 时，当前用户是否拥有管理员特权？运行于 Windows 95 或更高版本下的安装程序， Is 通常在参数 nFlag 为 USER_ADMINISTRATOR 时返回 TRUE

VALID_PATH ：由 szIsData 指定的路径是否一个合法路径？它不确认路径的存在与否，而仅检测它的语法。当你检索从用户处得到的路径信息时可以使用该常量。然后该函数会检测输入的路径信息是否正确。

WINDOWS_SHARED ： Microsoft Windows 是否从一个网络运行共享版本？

szIsData

指定信息，该信息依赖于传递给 nIsFlag 的常量，如下所示：

若 nIsFlag 是 DIR_WRITEABLE,szIsData 指定要被检测的全限定路径。

若 nIsFlag 是 FILE_EXISTS,szIsData 指定全限定文件名。

若 nIsFlag 是 FILE_LOCKED ， szIsData 指定全限定文件名。

若 nIsFlag 是 FILE_WRITEABLE ， szIsData 指定全限定文件名。

若 nIsFlag 是 MATH_COPROCESSOR ， szIsData 指定的内容被忽略。

若 nIsFlag 是 PATH_EXISTS ， szIsData 指定全限定路径。

若 nIsFlag 是 USER_ADMINISTRATOR ， szIsData 被忽略。

若 nIsFlag 是 VALID_PATH ， szIsData 指定全限定路径。

若 nIsFlag 是 WINDOWS_SHARED ， szIsData 被忽略。

返回值：

TRUE (1) ：表明答复为真。

FALSE (0) ：表明答复为假。

< 0 ：函数未能答复问题。

注解：

·常量 WINDOWS_SHARED 仅能应用于 Microsoft Windows 版本。一个 Microsoft Windows 的共享版本安装于网络且有可被许多用户共享的公用文件。

4 内部对话框函数

下列函数创建简单对话框，如 Yes/No 对话框和消息框。一些函数允许你简单地显示公用对话框的各种类型。

有 Cancel 按扭的内部对话框当该按扭被选中时不返回 CANCEL(2) 值。而是调用当前定义的退出处理程序。

注意：作为缺省， InstallShield Professional 6 以 Windows 2000 风格显示最终用户对话框，该风格遵照 Windows 用户界面的 Microsoft 的最新准则。为相应显示 Windows 95 风格的对话框，用户需做下列工作：

通过重命名或移至其它文件夹，将 <InstallShield Professional 6 文件夹 > 、 Redistributable\Compressed Files\0009-English\Intel 32\_isres.dll 备份。
将文件 _isres.old 从 <InstallShield Professional 6 文件夹 >\Program\Migration\0009-English\Intel 32 拷贝至 <InstallShield Professional 6 文件夹 >\Redistributable\compressed Files\0009-English\Intel 32 。
改变文件名 _isres.old 为 isres.dll 。
单击建立工具栏 Build toolbar' 的建立当前媒体按钮 Build Current Media 或从建立菜单选择建立 < 媒体名称 > 媒体来建立用户的媒体。

具体函数包括以下这些：

AskDestPath

显示一个要求目标路径信息的对话框。

AskOptions

显示一个对话框，提示最终用户通过复选框或单选钮来选择选项。

AskPath

显示提示最终用户输入一个路径的对话框。

AskText

显示提示最终用户输入文本的对话框。

AskYesNo

显示一个对话框，提示最终用户通过点击 Yes 或 No 按扭来响应问题。

ComponentDialog

显示一个对话框，让最终用户选择组件和指定一个目标位置。

EnterDisk

显示一个对话框，提示最终用户一个指定的磁盘。

MessageBox

在对话框中显示一条信息。

RebootDialog

显示一个对话框，使最终用户可以选择重启 Windows 或重启计算机。

SelectDir

显示一个对话框，允许最终用户选择一个文件夹。当文件夹不存在时 SelectDir 创建该文件夹。

SelectDirEx

显示一个对话框，允许最终用户选择一个文件夹。

SelectFolder

显示一个对话框，允许最终用户从程序文件夹列表中选择一个文件夹。

SetupType

显示一个对话框，允许最终用户选择典型、简易、自定义安装。

SprintfBox

返回一个由一个或多个字符、数字或字符串值组成的格式化的字符串。

Welcome

显示欢迎信息的对话框。

4.1 AskDestPath

语法： AskDestPath (szTitle, szMsg, svDir, nReserved);

说明： AskDestPath 函数显示一个对话框，允许最终用户指定安装中文件安装到的目标文件夹。对话框还包括一个浏览按扭，允许最终用户选择一个存在的文件夹或指定一个新的文件夹。注意最终用户选择的文件夹必须可写；不可写的文件夹不被接受。如果你希望最终用户可以选择不可写的文件夹，可调用 AskPath 函数。

为从选择目标位置对话框中打开选择文件夹对话框，最终用户必须点击浏览 (Browse) 按钮。选择文件夹对话框显示所有有效文件夹列表。最终用户可选择一个存在的文件夹或者输入一个新的文件夹名。如果最终用户输入一个不存在的文件夹名，该文件夹被创建。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择目标位置"），传递一个空字符串给该参数。

szMsg

指定要显示的消息。为在该参数传递多行静态文字，在行需要间断处插入新行转换符序列（\ n ）。为显示该对话框的缺省指令，传递空字符串（ "" ）给该参数。

svDir

指定打开对话框时显示的缺省路径；返回到达最终用户选择的文件夹的路径。更多信息请看下面的注解。

nReserved

该参数的值必须是 0 。

返回值：

NEXT (1) ：表明 Next 按钮被选中。

BACK (12) ：表明 Back 按钮被选中。

注解：

·如果由 svDir 指定的缺省文件夹不存在于最终用户系统中，它不会被创建，除非最终用户按下选择按钮并且从选择文件夹对话框中按步骤创建它。因此，当用户指定一个希望在调用 ComponentTransferData( 它在必要时会创建文件夹 ) 前使用的缺省文件夹时，用户必须在 AskDestPath 返回时调用 ExistDir 以此来确定文件夹是否存在。如果它不存在，调用 CreatDir 来在最终用户系统中创建它。注意一个运行基于事件的脚本的安装程序会自动调用 ComponentTransferData 。

· 运行在静止方式（ silent mode ）的安装程序，若缺省文件夹不存在，则必须在调用 AskDestPath 前创建它。

4.2 AskOptions

语法： AskOptions (nValue, szMsg, szText1, bvCheck1, szText2, bvCheck2[, szTextn, bvCheckn] [,..., ]);

说明： AskOptiona 函数格式化并显示提示最终用户选择一个或多个选项的对话框。对话框的缺省标题是"选择组件"。为改变标题栏的内容，在调用 AskOptions 前调用 SetDialogTitle 。该对话框将显示多至九个选择控件，复选框或单选钮，根据 nValue 的值而定。

参数：

nValue

指定要显示的控件。在该参数位置传递下列预定义常量之一：

EXCLUSIVE ：指定单选按钮，允许最终用户仅选择一个选项。

NONEXCLUSIVE ：指定复选框，允许最终用户选择一个以上的选项。

szMsg

指定在对话框显示的消息。你可以使用该消息来描述选项和 / 或要求最终用户选择一个或多个选项。如果消息多于一行，使用换行符（\ n ）插入行的间隔处。

szText1

指定一个最多达 47 个字母的文本标签，它相邻显示于第一个复选框或单选钮。为建立一个快捷键，在用户为该目的指定的字母前插入一个"与符号"（ & ）。该字母带下划线显示来指示它的功能。例如，自定义 Alt+C 为快捷键，传递" &Custom" 。自定义 Alt+S 为快捷键，传递" Cu&stom" 。

bvCheck1

指定对话框打开时第一个选择框或单选钮的初始状态；对话框关闭时返回第一个选择框或单选钮的状态。在该参数位置传递下列常量：

TRUE ：第一个选择框或单选钮被选。

FALSE ：第一个选择框或单选钮未被选中。

szText2

指定相邻显示于第二个选择框 / 单选钮的最多达 47 个字母的文本标签。创建一个快捷键的方法同 szText1 处。

bvCheck2

指定对话框打开时第二个选择框或单选钮的初始状态；对话框关闭时返回第二个选择框或单选钮的状态。在该参数位置传递下列常量：

TRUE ：第二个选择框或单选钮被选。

FALSE ：第二个选择框或单选钮未被选。

可以定义多达七个附加选项。每个附加选项由一对参数指示：一个字符串参数定义一个标签和一个数值型变量定义 AskOptions 返回时的选项状态。为设置一个选项的初始状态，在调用 AskOptions 前给数值型变量赋值为 TRUE 或 FALSE 。

若 nValue 是 EXCLUSIVE 并且一个以上的选项设置的初始状态设置为 TRUE ， AskOptions 将预选设置为 TRUE 的参数序列的第一个选项。

返回值：

NEXT (1) ：表明 Next 按钮被选。控件的状态由各个 bvCheck 变量返回。

BACK (12) ：表明 Back 按钮被选。控制的状态由各个 bvCheck 变量返回。

4.3 AskPath

语法： AskPath (szMsg, szDefPath, svResultPath);

说明： AskPath 函数指定一个对话框，提示最终用户输入目标位置的路径。对话框包括一个单行编辑区，你可以在此显示一个缺省路径。最终用户有三个选择：

接受缺省路径
编辑缺省路径
显示选择文件夹 Choose Folder 对话框来选择一个文件夹

　　对话的缺省标题是选择目标位置 Choose Destination Location 。为改变该标题，在调用 AskPath 前调用 SetDialogTitle 。 AskPath 不检验最终用户输入路径的存在性。调用 AskPath 后调用 CreatDir 来创建该路径。

参数：

szMsg

指定显示在对话框中的消息。要显示该对话框的缺省指示，传递空字符串 ("") 给该参数。

szDefPath

指定在编辑区显示的缺省路径。最终用户可以修改该字符串。

svResultPath

返回结果路径名，不管用户是否接受缺省路径，修改它，还是从选择文件夹 Choose Folder 对话框选择可选路径。 AskPath 在路径结尾加一个反斜杠，然后才把它赋给 svResultPath 。若必要，可在 AskPath 返回后通过调用 StrResultPath 来删除反斜杠。如果用户按下返回按钮， svResultPath 的值将不可预测。因此，如果用户在 szDefPath 和 svResultPath 使用相同的变量，那么确保当 AskPath 的返回值为 BACK 时重初始化该变量。

返回值：

NEXT (1) ：表明最终用户选择 Next 按钮。

BACK (12) ：表明最终用户选择 Back 按钮； svResultPath 设置为空字符串 ("") 。

注解：

·在对话框显示的编辑区可滚动以适应长字符串。

·因为可以输入至编辑区的字符数目不受限制，所以用户必须以不定长来说明 svResultPath 传递的变量。如果字符串变量不足以存储用户输入的文本，字符串将被截尾并且显示错误信息。同样要注意既然这个函数在字符串结尾附加一个反斜杠和一个空结束符，字符串的长度至少比用户输入的路径长两个字符。

·该函数将接受一个存在但不可写的文件夹。为限制最终用户只可选择可写的文件夹，可调用 AskDestPath 函数来替代。

4.4 AskText

语法： AskText (szQuestion, szDefault, svResult);

说明： AskText 函数显示一个对话框，它包括一个静态文本区和一个编辑框。参数 szQuestion 指定静态文本区的缺省文本；参数 szDefault 指定编辑框的缺省文本。该对话框的缺省标题是输入信息 Enter Information 。为改变标题栏的内容，在调用 AskText 前调用 SetDialogTitle 。

参数：

szQuestion

指定要显示的问题或声明。如果该参数位置的字符串长度超过静态文本区宽度，一个或多个行分隔符将会被插入该字符串使得它在对话框多行显示。如果愿意，用户也可以自己通过插入换行符（\ n ）手动格式化该字符串。该参数没有一个缺省值。

szDefault

指定编辑区的缺省文本。

svResult

当 Next 按钮被用来关闭对话框时返回由最终用户输入的文本。如果用户按下 Back 按钮， svResult 值将不可预测。因此，如果用户在 szDefPath 和 svResultPath 使用相同的变量，那么需确保当 AskPath 的返回值为 BACK 时重初始化该变量。

返回值：

NEXT (1) ：表明 Next 按钮被按下。

BACK (12) ：表明 Back 按钮被按下。

注解：

·用户在 svResult 传递的字符串变量必须足够大以适应输入到编辑区的文本。因此，用户必须使用自动调节大小的方法来声明变量。

·必要时，编辑区将会滚动来以适应一个长字符串。

4.5 AskYesNo

语法： AskYesNo (szQuestion, nDefault);

说明： AskYesNo 函数呈现一个消息框，显示一个问题，最终用户可以通过单击 Yes 或 No 按钮来回答它。 AskYesNo 消息包含四个内容：

．问题标记图标　　．问题文本　　． Yes 按钮　　． No 按钮

　　缺省标题是 Question 。为改变标题栏的内容，在调用 AskYesNo 前调用 SetDialogTitle 。

AskYesNo 消息框由直接调用相应的 Windows API 函数创建 , 它显示一个系统模态对话框。由于该对话框是由 Windows 显示的，按钮上的文本不能由安装改变。英语版本的文本 'Yes' 或 'No' 将由 Windows 以适合运行安装的 Windows 版本的语言显示。如果用户需要显示另一个柔性对话框，直接调用一个 Windows API 函数或使用一个自定义对话框。

参数：

szQuestion

指定显示在消息框中的问题。如果消息超过一行，在消息中嵌入换行符 (\n) 来插入行间隔。

nDefault

指定缺省选定的按钮。在该参数位置传递下列预定义的常量之一：

YES ：当对话框打开时 Yes 按钮高亮显示。

NO ：当对话框打开时 No 按钮高亮显示。

返回值：

YES (1) ：表明用户选择 Yes 按钮。

NO (0) ：表明用户选择 No 按钮。

4.6 ComponentDialog

语法： ComponentDialog (szTitle, szMsg, svDir, szComponent);

说明： ComponentDialog 函数显示一个对话框，允许最终用户从当前媒体上的组件列表中选择一项或多项。用户也可以选择一个目标位置。

如果你的安装不使用一个安装类型对话，用户必须在调用 ComponentDialog 前调用 ComponentTypeSet 来指定一个已经在 IDE 安装类型窗格中定义的安装类型。

当前媒体的名称存储在系统变量 MEDIA 中。在安装初始化过程中， InstallShield 给 MEDIA 赋值为缺省媒体名称 ("DATA") ，它和用户文件媒体库（ Data1.cab ）相联系。显示脚本创建的组件时，按下列步骤进行：

保存 MEDIA 的当前值
将脚本创建组件组的名称赋给 MEDIA
调用 ComponentDialog 得到最终用户的选择
将步骤 1 的值赋给 MEDIA

在安装初始化中系统变量 MEDIA 的值设置为 'DATA' 。如果用户改变该变量的值来引用脚本创建的组件组，用户必须在调用 ComponentTransferData ， CreateShellObjects 或 CreateRegistrySet 前将值改回 'DATA' 。注意在一个基于事件的脚本的安装中 ComponentTransferData 被自动调用。

单击浏览按钮装入选择文件夹 Choose Folder 对话框，显示存在的文件夹列表。最终用户可以选择一个存在的文件夹或输入一个新的文件夹名称。 ComponentDialog 在 svDir 返回被选的文件夹名称。

如果用户输入一个不存在的文件夹，将出现一个消息框来询问最终用户是否要创建这个文件夹。如果是，则 InstallShield 创建指定的文件夹。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件 Select Components "），给该参数传递一个空字符串（ "" ）。

szMsg

指定在对话框显示的消息。例如，消息可能为"请选择一个或多个下列组件安装在你的系统上" "Please select one or more of the following components to install on your system." 。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。

svDir

指定缺省目标位置。返回最终用户选择的文件夹。注意在 svDir 返回的位置值不影响文件传输除非用户将它赋值给系统变量 TARGETDIR 或调用 ComponentSetTarget 来将它和一个用户定义的变量联系起来。

我们建议用户给该参数传递 TARGETDIR 而不是一个字符串变量。如果你在该参数不传递 TARGETDIR ，当最终用户在一个不同驱动器选择一个目标时显示在对话框的所需磁盘空间不会被重算。

szComponent

指定组件，其子部件被显示以供选择。给该参数传递一个空字符串（ "" ）来显示所有顶层组件。

ComponentDialog 在文件媒体库或脚本创建的组件组中查找由系统变量 MEDIA 指定的所需组件。

返回值：

NEXT (1) ：表明最终用户选择 Next 按钮。

BACK (12) ：表明最终用户选择 Back 按钮。

< 0 ：未能显示 ComponentDialog 对话框。调用 ComponentError 查看附加信息。

注解：

·组件大小显示为 0 直到它被选中。一旦它被选中，它的实际大小被显示。

·若有必要，组件名称被截尾来显示最大可能的组件大小。显示大小的必要空间依赖于组件最大大小本身（ 2GB ），当前使用的组件大小选项，和用来在对话框显示组件信息的字体。组件大小选项由 DialogSetInfo 函数设置。一旦显示最大可能大小所需的空间被确定，若有必要，所有组件名均被截尾以适应剩余空间。这确保组件名不会覆盖组件大小。注意，在这种方法下需要较少空间显示大小（或没有被选）的组件的名称仍然会被截尾。为了最大化执行并确保组件名称完整显示，使组件名小于在组件对话框中的有效空间。

· 如果由 svDir 指定的缺省文件夹不存在于最终用户系统，它不会被创建除非最终用户按下浏览按钮并按下列步骤从选择文件夹对话框创建它。因此，无论何时用户想在调用 ComponentTransferData( 必要时，它会创建文件夹 ) 前指定一个要使用的缺省文件夹，为了确定该文件夹是否存在，当 ComponentDialog 返回时都必须调用 ExistDir 。如果不存在，调用 CreatDir 在最终用户系统上创建它。

·运行在静止方式的安装如果在调用 ComponentDialog 前文件夹不存在必须创建该新文件夹。这样可以确保确认对话框不被显示。没有这一步，需要两个响应文件来处理两个可能情况。

4.7 EnterDisk

语法： EnterDisk (szMsg, szTagFile);

说明： EnterDisk 函数显示一个对话框，提示最终用户插入下一张磁盘。缺省标题是安装需要下一张磁盘。为改变该标题，在调用 EnterDisk 前调用 SetDialogTitle 。系统变量 SRCDIR 包含缺省路径，该路径显示在对话框中。最终用户可以修改缺省路径并通过输入一个新路径和单击 OK 来修改 SRCDIR 值。

EnterDisk 通过在磁盘查找由 szTagFile 指定的标签文件识别正确磁盘。如果磁盘不包含标签文件，会有一个错误消息提示用户输入正确磁盘。

参数：

szMsg

指定提示用户插入正确磁盘的消息。

szTagFile

指定标签文件名。 EnterDisk 在插入磁盘上查找该文件。如果文件没有找到，会显示一个消息要求用户插入正确的磁盘。如果用户给该参数传递一个空字符串 ("") ，函数不查找任何文件；而是假定安装了正确的软盘。

返回值：

OK (1) ：表明用户选择了 OK 按钮。

< 0 ：表明发生了一个未确定错误。

注解：

· InstallShield 媒体生成器不会自动在磁盘映像文件夹上生成标签文件。为使用标签文件，将它们加到创建好的磁盘映像文件夹中。

4.8 MessageBox

语法： MessageBox (szMsg, nType);

说明： MessageBox 函数呈现一个对话框，包含一个消息，一个指示消息自然属性的图标（信息，警告，或严重警告），和一个 OK 按钮。缺省标题依赖于 nType 值， nType 值也指示图标类型。为改变消息框标题栏的内容，在调用 MessageBox 前调用 SetDialogTitle 。

参数：

szMsg

指定要显示的消息。 InstallShield 不会自动分隔消息文本为单独的行来适应消息框。如果消息长于一行，通过在字符串的合适位置嵌入换行符 (\n) 来插入行间隔。

nType

指定要创建的消息框类型和显示在消息框的图标类型。在该参数位置传递下列预定义的常量之一（显示资源管理器对象处理程序图标）：

INFORMATION WARNING SEVERE

任何 Windows API MessageBox 类型也可在该参数指定。多种风格可以被逻辑或来产生所需的 MessageBox 类型（请看下面的注解）。

返回值：

除非你使用标准 Microsoft Windows 消息框风格，返回值没有意义。如果你使用这些风格，返回值和 MessageBox API 函数的返回值一样。

注解：

·该函数使用 Microsoft Windows API MessageBox 。操作环境，而不是 InstallShield ，确定消息框的大小和位置（例如，操作系统运行所在的语言）。你可以改变该按钮的文本。考虑使用 Windows MessageBox 类型的更多信息，请在适当的 Windows SDK 中咨询 MessageBox Windows API 函数的描述。

·当使用 Windows 消息框常量时注意下列情况：

· Windows MessageBox 类型常量在 Windows.h 文件中声明，它不能包括在 InstallShield 脚本中。当使用这些常量，用户必须在安装脚本的声明区定义它们（使用 #define ）。赋给这些常量的值通常可在一个适当的 Windows SDK 或开发工具提供的包含文件中找到。对于 Microsoft Visual C++ ，大多数常量可在 Winuser.h 文件中找到，它位于 DevStudio\Vc\include 文件夹。

· Windows 和 InstallShield 消息框常量不能在一个安装中一起使用。如果一个 InstallShield 消息框常量和一个 Windows 消息框常量用一个或运算符组合， Windows 消息框常量将被忽略。

·一些 Windows 消息框风格在一些 Windows 平台不受支持。为确定一个特定的风格是否受安装确定的操作系统支持，咨询适当的 Windows SDK 。

·当 MessageBox 函数使用一个 Windows 消息框风格时，消息框的标题是"安装"。如果用户需要显示不同的标题，可使用 SprintfBox 函数来替代。

4.9 RebootDialog

语法： RebootDialog (szTitle, szMsg, nDefChoice);

说明： RebootDialog 函数显示一个对话框 , 允许最终用户重启计算机。被选的选项在安装的最后被执行。

参数：

szTitle

指定对话框标题。为显示缺省标题（"重新启动"），给该参数传递一个空字符串 ("") 。

szMsg

指定对话框显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串 ("") 。

nDefChoice

指定缺省选定的单选钮内容。在该参数位置传递下列预定义常量之一：

SYS_BOOTMACHINE ：重启计算机选项 ("Yes, I want to restart my computer now.") 将成为缺省单选按钮选定内容。

0 ：不重启计算机选项 ("No, I will restart my computer later.") 将成为缺省单选按钮内容。

返回值：

WILL_REBOOT ：表明用户选择标签为 "Yes, I want to restart my computer now." 的单选钮。

0 ：表明用户选择标签为 "No, I will restart my computer later." 的单选钮。

注解：

·当你带 SHAREDFILE 或 LOCKEDFILE 选项来调用一个函数并且锁定遇到的 .dll 或 .exe 文件，锁定的文件的更新版本被拷贝至目标系统并且系统变量 BATCH_INSTALL 设置为 TRUE 。 RebootDialog 当系统重启时自动提交被锁定的文件以更新，除非用户选择 "No, I will restart my computer later." 选项。

· RebootDialog 函数的一个完美候选是 SdFinishReboot ，它比 RebootDialog 对话框一个更好的外观和感觉。

·因为当 InstallShield 的其它实例运行时 InstallShield 会尽力不重启系统，所以用户必须确保所有其它 InstallShield 的实例在调用 RebootDialog 前停止执行。另外，你给用户的消息需要求他们确保在重启系统前所有其它应用程序停止执行。

4.10 SelectDir

语法： SelectDir (szTitle, szMsg, svDir, bCreate);

说明： SelectDir 函数显示一个对话框，允许最终用户指定应用程序将被安装到的文件夹。最终用户可以输入一个全限定文件夹名或从列表中选择一个存在的文件夹。如果最终用户输入一个无效文件夹名或一个未限定文件夹名，将显示一个消息框提示最终用户输入一个有效名。选择文件夹的全限定名返回给 svDir 。

如果指定的文件夹不存在并且参数 bCreate 是 TRUE ，显示一个消息框询问是否要创建文件夹。如果最终用户单击 Yes, SelectDir 自动创建指定的文件夹。如果参数 bCreate 设置为 FALSE 并且一个不存在的文件夹被选中，最终用户不会被告之，并且 SelectDir 不创建它。这种情况下，该由用户处理包含在 svDir 的选项。

当最终用户单击呈现在由 AskDestPath, SdAskDestPath 和其它获得一个文件夹名的 InstallShield 函数显示的对话框中的 Browse 按钮时 SelectDir 被自动调用。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择文件夹"），给该参数传递一个空字符串（ "" ）。

szMsg

指定用户要在该对话框显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串 ("") 。

svDir

指定将作为缺省选项显示的文件夹名。返回由最终用户选定的文件夹的全限定名。

bCreate

指定你是否要求 InstallShield 在指定文件夹不存在时创建它。在该参数位置传递下列预定义常量之一：

TRUE ：表明如果文件夹不存在则需被创建。

FALSE ：表明如果文件夹不存在不需被创建。

返回值：

IDOK (1) ：表明 OK 按钮被按下。

IDCANCEL (2) ：表明 CANCEL 按钮被按下。

< 0 ：表明该函数未能显示对话框并 / 或不能创建文件夹。

4.11 SelectDirEx

语法： SelectDirEx (szTitle, szMsg, szEditBoxStaticText, szTreeControlStaticText, nFlags, svDir);

说明： SelectDirEx 显示一个对话框，允许最终用户从一个显示存在文件夹的树形控件中选择一个存在的文件夹。也显示一个编辑框，允许最终用户指定一个新文件夹。

该函数调用 Windows API 函数 SHBrowserForFolder 来显示对话框。为得到 SHBrowseForFolder 更多信息，可查看 Win32 SDK 或访问 http://msdn.microsoft.com/library/ sdkdoc/ shellcc/shell/Function s/SHBrowseForFolder.htm.

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择文件夹"），给该参数传递一个空字符串（ "" ）。

szMsg

指定用户要在该对话框显示的消息。为显示该对话框的缺省指示（"请选择安装文件夹"），给该参数传递一个空字符串 ("") 。

szEditBoxStaticText

当 nFlags 为 BIF_EDITBOX 时指定伴随编辑框的静态文本。如果 nFlag 不指定 BIF_EDITBOX ，该参数被忽略。

szTreeControlStaticText

当 nFlags 指定 BIF_STATUSTEXT 时，指定伴随对话框的树形控件的静态文本。如果 nFlags 不指定 BIF_STATUSTEXT ，该参数被忽略。

nFlags

指定函数显示的对话框的外观和功能。传递任何下列常量：

BIF_BROWSEFORCOMPUTER ：允许最终用户选择网络上的一特定计算机。当传递该常量时，对话框有如下行为（性能）：

"网络邻居"文件夹在树形控件中被预选。
仅当选中树形控件中的一个有效计算机名时， OK 按钮被激活。
即使 BIF_EDITBOX 指定时也不显示编辑框。

BIF_BROWSEFORPRINTER ：允许最终用户选择一特定打印机。当传递该常量时，对话框有如下行为：

"网络邻居"文件夹在树形控件中被预选。
仅那些包括至少一台打印机的计算机在网络邻居文件夹中显示。
仅当选中树形控件中的一个有效打印机时， OK 按钮被激活。
即使 BIF_EDITBOX 指定时也不显示编辑框。

BIF_DONTGOBELOWDOMAIN ：域层下的网络文件夹不在树形控件中显示。

BIF_RETURNFSANCESTORS ：如果一个文件系统祖先以外的任何对象被选中时 OK 按钮被禁用。

BIF_RETURNONLYFSDIRS ：非文件系统某部分的一个文件夹被选中 OK 按钮被禁用。 .

下列常量指定对话框的其它特征：

BIF_EDITBOX ：显示一个编辑框，允许用户输入一文件夹名，在编辑框上部显示 szEditBoxStaticText 中的文本（除非指定 BIF_BROWSEFORCOMPUTER 或 BIF_BROWSEFORPRINTER ）。当最终用户单击 OK ， SelectDirEx 检查是否输入了一个有效文件夹名。如果不是（例如，如果输入了包含无效字符的名称），显示一个错误消息并且对话框不被消除。和 SHBrowseForFolder 不同， SelectDirEx 对所有 InstallShield 支持的操作系统都支持该常量。

BIF_STATUSTEXT ：在树形控件上部作为态文本显示 szTreeControlStaticText 。注意 SelectDirEx 不支持 BIF_VALIDATE 和 BIF_USENEWUI 常量，而 SHBrowseForFolder 支持它们。

svDir

指定作为缺省选择出现的文件夹名。返回由最终用户选择的文件夹的全限定名。如果该参数指定了一个存在于系统的有效文件夹名，该文件夹在树形控件中被预选。

返回值：

IDOK (1) ：表明 OK 按钮被按下。

IDCANCEL (2) ：表明 CANCEL 按钮被按下。

< 0 ：表明函数未能显示对话框。

4.12 SelectFolder

语法： SelectFolder (szTitle, szDefFolder, svResultFolder);

说明： SelectFolder 函数显示一个对话框，允许最终用户在一个编辑区输入一个程序文件夹名或从一个列表中选择一个程序文件夹。该函数自动显示系统中所有的程序文件夹。 SvDefFolder 传递的一个缺省的文件夹名在编辑区显示。在 svResultFolder 返回被选的文件夹名。如果指定文件夹不存在，它不会被创建。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择程序文件夹"），给该参数传递一个空字符串（ "" ）。

szDefFolder

指定作为缺省文件夹显示的文件夹名。

svResultFolder

返回由最终用户选中或指定的文件夹名。如果文件夹不存在，你必须调用 CreateProgramFolder 来创建它； SelectFolder 不会创建该文件夹。

返回值：

NEXT (1) ：表明最终用户选择 Next 按钮。

BACK (12) ：表明最终用户选择 Back 按钮。

< 0 ：表明函数未能成功执行。

4.13 SetupType

语法： SetupType (szTitle, szMsg, szReserved, nType, nReserved);

说明： SetupType 函数显示一个对话框允许最终用户选择三种标准安装类型之一。典型、简易或自定义。这些安装选项显示时有标准描述文本。如果你想加入其它安装类型或改变显示的安装类型名或描述，可调用 SdSetupTypeEx 。

如果最终用户在使用组件对话框来选定和撤消选定与已选安装类型相联系的组件后，返回到安装类型对话框，那么那些选择将丢失。这种情况发生是因为 SetupType 函数每次被调用时自动根据选中的安装类型复位缺省组件选项。

参数：

szTitle

指定对话框标题。为显示缺省标题（"安装类型"），给该参数传递一个空字符串（ "" ）。

szMsg

指定你要在对话框顶部显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。

szReserved

给该参数传递一个空字符串 ("") ，不允许其它值。

nType

当对话框打开时指定缺省安装类型。在该参数位置传递下列预定义常量之一：

TYPICAL ：定义缺省安装类型为典型。

COMPACT ：定义缺省安装类型为简易。

CUSTOM ：定义缺省安装类型为自定义。

nReserved

给该参数传递 0 ，不允许其它值。

返回值：

TYPICAL (301) ：表明选择了典型安装类型。

COMPACT (302) ：表明选择了简易安装类型。

CUSTOM (303) ：表明选择了自定义安装类型。

BACK (12) ：表明选定了 Back 按钮。

4.14 SprintfBox

语法： SprintfBox (nType, szTitle, szFormat [,arg] [,...]);

说明： SprintfBox 函数呈现一个消息框，它包含三个图标之一，一个标题，和一个格式化的消息。该消息可以包含根据你输入的命令格式化的变量。

SprintfBox 和 MessageBox 相似，但 SprintfBox 对显示的内容允许更多的弹性控制。

参数：

nType

指定显示在消息框中的图标类型。在该参数位置传递下列预定义的常量之一（显示 Windows 95 图标）：

INFORMATION 信息

WARNING 警告

SEVERE 严重警告

szTitle

指定消息框标题。为显示缺省标题（"错误"），给该参数传递一个空字符串（ "" ）。

szFormat

指定一个包含一个格式说明符的字符串，格式说明符是针对包含在消息中的每个参数的。

arg

指定包含在消息中的参数，至多可达 10 个。对消息中每个格式说明符必须有一个参数；每个参数类型必须和它各自的格式说明符相匹配。 SprintfBox 在下列情况下将产生一个编译错误或在运行时失败：

·指定多于十个格式说明符和参数：编译错误。

·参数数目和格式说明符数目不匹配。当一个说明符没有相应的参数，结果字符串将在说明符位置包括不可预测的字符。当参数多于说明符，多余的参数将被插入到结果字符串中。

·一个变量和它各自的格式说明符不匹配。结果字符串将在说明符位置包含不可预测字符。

返回值：

除非你使用本机的 Windows 消息框风格（描述如下），返回值是没有意义的。

注解：

·该函数使用 Microsoft Windows API MessageBox 来创建消息框。消息框的 OK 按钮包含操作环境产生的文本。是操作环境而不是 InstallShield 确定消息框的大小和位置。

·熟悉 Windows API 的高级开发者可以通过在参数 nType 使用本机消息框风格常量来指定任何风格的消息框。查看你的操作环境编程手册中 MessageBox 或 WinMessageBox 的说明。如果你使用任何本机消息框风格， InstallShiled SprintfBox 函数将返回 Windows API 的返回值。因此，你必须在你的脚本中使用 Windows API 的返回值。

例如，如果你传递 YES|NO|CANCEL 作为第一个参数， SprintfBox 消息框将有 Yes,No 和 Cancel 按钮。各个按钮返回值，如 Windows API MessageBox 定义，是 6 (IDYES), 7 (IDNO), 和 2 (IDCANCEL) 。你必须在你的脚本中使用适当的常量值，作为数字或作为在你的脚本的声明区中定义为数字的常量。

·高级开发者可以直接使用 MB_STYLE 作为 SprintfBox 函数的第一个参数来代替常量 SEVERE, WARNING 或 INFORMATION 。 MB_STYLE 的值列在 Windows.h 中。你可以给参数 nType 直接输入值，或可以使用 #define 预处理程序指令来定义和该值联系的常量。

·当使用 Windows 消息框常量时注意下列问题：

· Windows MessageBox 类型常量在 Windows.h 文件中声明，它不能被包括在一个 InstallShield 脚本中。当使用这些常量时，你必须在安装脚本的声明区定义它们（用 #define ）。赋给这些常量的值通常可以在由适当的 Windows SDK 或开发工具提供的一个包含文件中找到。对于 Microsoft Visual C++ ，大多数常量可以在位于 DevStudio\Vc\include 文件夹的 Windows.h 文件中找到。

·一些 Windows 消息框风格在一些 Windows 平台不受支持。为确定一个特定的风格是否受安装确定的操作系统支持，咨询适当的 Windows SDK 。

4.15 Welcome

语法： Welcome (szTitle, nReserved);

说明： Welcome 函数显示一个对话框来欢迎最终用户。

参数：

szTitle

指定该对话框的标题。为显示缺省标题（"欢迎"），给该参数传递一个空字符串。

nReserved

给该参数传递 0 。

返回值：

NEXT (1) ：表明最终用户选择 NEXT 按钮。

BACK (12) ：表明最终用户选择 BACK 按钮。

< 0 ：表明 Welcome 未能显示对话框。

注解：

·在一个过程脚本中，为使 InstallShield 可以在欢迎对话框的消息文本的第一段中插入产品名称，你必须在调用 Welcome 前调用 SdProductName 。（在一个基于事件的脚本中，在 Begin 事件前， SdProductName 被自动调用，以 PRODUCT_NAME 字符串表入口为参数）。如果你不使用 SdProductName 来传递一个产品名称， InstallShield 不能插入产品名称而是将插入一个附加的空格。

5 Sd 对话框函数

InstallShield 提供一些 Sd 对话框函数，用户可自定义和显示。 Sd 对话框使用可以创建用户输入的对话框的特殊脚本定义函数来创建。然后该对话框根据所作选择返回值给脚本。

Sd 对话框有一个 Cancel 按钮，当它被选中时不返回一个 CANCEL 值。而是调用缺省的退出处理。

下面是所有有效的 Sd 对话框函数的列表：

DialogSetInfo

改变由一些内部对话框函数呈现的对话框的显示元素。

SdAskDestPath

呈现一个对话框，允许最终用户指定安装的一个目标位置。

SdAskOptions

创建一个对话框，它比标准 AskOptions 函数更灵活。

SdAskOptionsList

呈现一个对话框，允许最终用户选定和撤消选定一个列表中的项目。

SdBitmap

在对话框中显示一个位图。

SdComponentDialog

显示一个对话框，允许最终用户选择安装的组件和目标文件夹。

SdComponentDialog2

显示一个对话框，允许最终用户选择要安装的文件夹、组件和子部件。

SdComponentDialogAdv

显示一个对话框，允许最终用户选择安装的组件和目标文件夹。

SdComponentMult

显示一个对话框，允许最终用户选择安装的组件和子部件。有关磁盘空间的附加信息也被提供来确定安装的最佳位置。

SdComponentTree

显示一个有树形控制控件的对话框，允许最终用户选择安装的组件和子部件。有关磁盘空间的附加信息也被提供来确定安装的最佳位置。

SdConfirmNewDir

提示用户确认文件夹的选择。

SdConfirmRegistration

提示最终用户确认输入到由 SdRegisterUser 或 SdRegisterUserEx 呈现对话框中的信息。

SdDisplayTopics

显示主题列表。

SdExceptions

显示一个对话框，通知最终用户遇到一个共享、锁定（在使用中）或只读文件。

SdFinish

显示一个对话框，通知最终用户安装完成并提供一个选项的选择，如是否要查看信息文件或运行一个应用程序。

SdFinishEx

显示一个对话框，通知最终用户安装完成。

SdFinishReboot

显示一个对话框，通知用户安装完成并提供一个重启 Windows 和计算机选项的选择。

SdInit

准备一个调用 Sd 对话框函数的安装。

SdLicense

显示一个许可证协议并给最终用户一个接受或拒绝许可证条款的选项。

SdLoadString

返回和一个指定资源 ID 相联系的字符串值。

SdMakeName

创建一个自定义对话框的节名。该节名在向一个 .iss 文件写或从一个 .iss 文件读时使用。 .iss 文件由 InstallShield Silent 使用。

SdOptionsButtons

显示一个有用户定义按钮的对话框，提供给最终用户不同选择。

SdProductName

在脚本对话框的特定静态区中插入你的产品名。

SdRegisterUser

显示一个可输入用户名和公司名的对话框。

SdRegisterUserEx

显示一个对话框，最终用户可在里面输入用户姓名、公司名称和应用程序序列号。

SdSelectFolder

呈现一个对话框，允许最终用户从程序文件夹列表中选择一个文件夹。

SdSetupType

显示一个对话框，使最终用户能选择三种标准安装类型之一：典型、简易或自定义。

SdSetupTypeEx

显示一个对话框，允许最终用户选择标准或自定义安装类型。

SdShowAnyDialog

显示一个资源 DLL 的通用对话框。当用 SdShowAnyDialog 函数显示一个对话框时你不能从最终用户接受任何输入。

SdShowDlgEdit1

显示一个对话框，它有一个单行的编辑区和其它静态控件。

SdShowDlgEdit2

显示一个对话框，有两个单行的编辑区和其它静态控件。

SdShowDlgEdit3

显示一个对话框，有三个单行的编辑区和其它静态控件。

SdShowFileMods

呈现一个对话框，预览对文件的可能修改并允许最终用户同意修改、拒绝修改或要求将修改写到一个文件中。

SdShowInfoList

在一个对话框中显示一个可滚动的消息列表。

SdShowMsg

在一个小窗口中显示一个消息。

SdStartCopy

呈现一个对话框，显示已经由最终用户指定的选项和设置。

SdWelcome

显示一个通用欢迎。

SdWelcomeMaint

显示一个在维护安装开始时使用的对话框。

5.1 DialogSetInfo

语法： DialogSetInfo (nInfoType, szInfoString, nParameter);

说明： DialogSetInfo 函数修改下列在 InstallShield 对话框中显示的元件：

显示的图象；
得到最终用户选择的复选框的风格；
指示有效和所需磁盘空间值的精度。

通过调用 DialogSetInfo 产生的修改对安装的剩余部分保持为有效或直到它们又被随后的对 DialogSetInfo 的调用修改。如果你的脚本在调用任何 Sd 对话框函数前调用 DialogSetInfo ，在 DialogSetInfo 的调用前必须先调用 SdInit 。否则，对 DialogSetInfo 的调用无效。

参数：

nInfoType

指定要修改的显示特征。在该参数位置传递下列预定义的常量之一：

DLG_INFO_USEDECIMAL ：缺省时，显示的指示组件大小、有效磁盘空间和所需磁盘空间的值被四舍五入到最近的 KB 或 MB 。下列对话框受该参数影响： ComponentDialog, SdComponentDialog, SdComponentDialog2, SdComponentDialogAdv 和 SdComponentMult 。

DLG_INFO_KUNITS ：缺省时，显示的指示组件大小、有效磁盘空间和所需磁盘空间的值以 KB 为度量。传递该参数同时 nParameter 设置为 FALSE 时则以 MB 为度量显示这些值。下列对话框受该参数影响： SdComponentTree, ComponentDialog, SdComponentDialog, SdComponentDialog2, SdComponentDialogAdv 和 SdComponentMult 。

DLG_INFO_ALTIMAGE ：指定一个显示在该对话框中的候选位图。如果 nParameter 设置为 TRUE ， szInfoString 必须指定在该对话框显示的图象。该参数应用于所有在对话框右上角显示标准安装图象的 InstallShield 对话框（和图象显示在对话框左边一个大图象的右上角的 Welcome, SdWelcome 和 SdFinish 对话框）。更多的信息可查看下面参数 nParameter 处描述的"当 nInfoType 是． DLG_INFO_ALTIMAGE" 。

由 SetDisplayEffect 设置的显示效果不能应用到交替图象 , 通常它们显示时没有任何特殊效果 .

DLG_INFO_CHECKSELECTION ：指定选择方法将由 nParameter 传递的常量确定。注意 SdComponentTree 不支持改变复选框类型。

szInfoString

当 DLG_INFO_ALTIMAGE 传递给 nInfoType 时，该参数指定要显示的候选位图的文件名和一组位图属性（可选）。如果包括了位图属性，传递给该参数的字符串必须如下格式化：

"位图文件名；透明标志； < 未用 > ； < 未用 > ；透明色"

位图文件名：

指定位图文件名。如果文件名未限定（也就是说，如果它不包括一个驱动器指示符和路径）， InstallShield 在 SUPPORTDIR 查找该位图。

透明标志：

指示是否透明显示位图。当该标志是 1 （真）时，该位图中所有其颜色是由 szInfoString 的透明色参数指定的 RGB 值的部分都透明显示。该参数缺省为 0 （非透明）。

未用：

格式行的这些部分都被忽略，但它们必须被包括。也就是说，格式行串必须包括四个分号，三个分号在透明标志和透明色之间。

透明色：

指示透明显示的颜色。透明色必须用一个 RGB 值来表示，也就是，三个数值型值由逗号分隔。如果没有指定值，即使透明标志设置为 1 ，位图也不会被透明显示。

下面的例子将显示 MyBitmap.bmp 文件的位图，它位于 SUPPORTDIR 文件夹。位图所有黑色部分（ RGB 值为 0 ， 0 ， 0 ）将被透明显示。

"MyBitmap.bmp;1;;;0,0,0"

注意：标准位图为 57 ×53。一个候选位图必须也约是这个大小。如果位图大于这个大小，它会在标题区中垂直置中，位图的右边将和对话框的右边对齐。（在 Welcome, SdWelcome, 和 SdFinish 对话框中，位图的右边将和它所呈现在的更大的位图的右边对齐）。位图左边将尽可能扩展到对话框左边。位图扩展在对话框标题区下的任何部分将被剪切掉。如果位图小于 57 ×53，它将被正确显示，但它将不被调整大小或被扩展。

当缺省位图被重新装入或 nInfoType 不是 DLG_INFO_ALTIMAGE 时该参数被忽略

nParameter

和 nInfoType 相联系一起来指定对话框特性。

当 nInfoType 是 DLG_INFO_CHECKSELECTION 时，传递下列预定义常量之一来指定复选框风格：

CHECKBOX ：指定 Windows 3.1 风格的复选框。

CHECKBOX95 ：指定标准（ Windows 95 风格）复选框。如果不调用 DialogSetInfo ，这是缺省的复选框风格。

CHECKLINE ：指定复选行风格的复选框。

CHECKMARK ：指定复选标记风格的复选框。

当 nInfoType 是 DLG_INFO_ALTIMAGE ，传递下列预定义常量之一来指定显示位图：

-1 ：指定对话框必须显示缺省位图。

TRUE ：指定由 szInfoString 指示的位图必须在随后的对话框中使用，就如前面在 szInfoString 下描述的一样。

当 nInfoType 是 DLG_INFO_KUNITS 或 DLG_INFO_USEDECIMAL 时，传递下列预定义常量之一来指定大小如何显示：

TRUE ：指定大小按照 nInfoType 指示的显示。

FALSE ：指定大小按照缺省风格显示。

返回值：

0 表明函数成功设置了指定的风格。

< 0 表明函数未能设置该风格。

注解：

·为预览调用 DialogSetInfo 的效果，运行 InstallShield 范例，改变对话框的属性（通过单击属性按钮），然后检验如 SdComponentDialog2 和 SdComponentMult 的对话框的改变。

·每次你要改变一个对话框的细节方面时都必须调用 DialogSetInfo 。

你可以使用 DLG_INFO_ALTIMAGE 参数来激活 16 色、 256 色或真彩色（ 24 位）的位图。注意当 256 色的位图在 16 色系统中显示或真彩色位图在 256 色系统中显示时会有颜色失真。建议你指定一与目标系统的颜色模式兼容的候选图象。

5.2 SdAskDestPath

语法： SdAskDestPath (szTitle, szMsg, svDir, nReserved);

说明： SdAskDestPath 函数创建一个对话框，允许最终用户选择一个候选目标路径。当你单击对话框中的浏览按钮， SelectDir 函数被调用来打开一个二次对话框使最终用户可以选择一个存在的文件夹或输入一个新的文件夹名。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择文件夹"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的文本。该文本被考虑为一个静态控件。在你的消息字符串中使用 %P 位置夹来插入已经由先前的一个对 SdProductName 的调用指定的产品名称（如果有）。为显示对话框的缺省指示，传递一个空字符串 ("") 。

svDir

指定缺省选定的目录名。返回由最终用户选定的目录名。

nReserved

给该参数传递 0 。不允许其它值。

返回值：

NEXT (1) ：指定 Next 按钮被单击。

BACK (12) ：指定 Back 按钮被单击。

注解：

·运行在静止方式的安装程序必须创建在调用 SdAskDestPath 前不存在的新文件夹。这样可以确保确认对话框不被显示。没有这一步骤，则需要两个响应文件来处理两种可能情况。

5.3 SdAskOptions

语法： SdAskOptions (szTitle, szMsg1, szMsg2, szId, szComponents, nExclusiveFlag);

说明： SdAskOptions 函数创建一个对话框，提供安装选项。你可以使用复选框或单选钮作为选择按钮。显示在按钮旁边的信息从一组选项中检索得到。选项的缺省数目是 4 。必要时你可以增加或减去组中选项的数目。

SdAskOptions 运行于由系统变量 MEDIA 指定的当前媒体上。在安装的初始化中， InstallShield 给 MEDIA 赋缺省媒体名（" DATA "），它和你的文件媒体库（ Data1.cab ）相联系。为显示脚本创建的组件，可按 4.6 中的相同步骤进行：

　　如果你的安装不使用一个安装类型的对话框，你必须在调用 SdAskOptions 之前调用 ComponentSetupTypeSet 来指定一个已经在 IDE 安装类型窗格中定义的安装类型

　　系统变量 MEDIA 的值在安装初始化过程中被设置为 'DATA' 。如果你改变该变量的值来指向一个脚本创建组件组，你必须在调用 ComponentTransferData, CreateShellObjects, 或 CreateRegistrySet 前将值修改回 'DATA' 。注意运行一个基于事件的脚本的安装中， ComponentTransferData 被自动调用。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件"），给该参数传递一个空字符串（ "" ）。

szMsg1

指定显示在对话框的消息。该静态区的 ID 是 801 。为显示该对话框的缺省指示，给该参数传递一个空字符串 ("") 。

szMsg2

指定在对话框显示的一个二次消息。该静态区的 ID 是 802 。

SzId

指定一个候选数值型对话框 ID 。仅使用以字符串形式表示的数值型 ID （例如， ID 13001 为" 13001 "）。你可以拷贝 SdAskOptions 对话框资源，对它做有限的修改，给它一个唯一数值型 ID ，并通过以字符串传递它的 ID 给 szId 来调用对话框。参考下面的注解部分。为创建标准的四选项的 SdAskOptions 对话框，给该参数传递一个空字符串 ("") 。

szComponents

指定要显示的包含子部件的组件名称。子部件前面有复选框或单选钮。为显示所有顶层组件，给该参数传递一个空字符串（ "" ）。

SdAskOptions 在由系统变量 MEDIA 指定的文件媒体库或脚本创建组件组中查找所需组件。

nExclusiveFlag

指定你要在对话框中显示的按钮类型。在该参数位置传递下列预定义常量之一：

EXCLUSIVE ：指定单选钮。

NONEXCLUSIVE ：指定复选框。

　　如果你的安装包括必需的可见的组件，不要调用 SdAskOptions 来得到安装选项。而是，以非静止方式调用 ComponentDialog, SdComponentDialog, SdComponentDialogAdv, SdComponentMult 或 SdAskOptionsList 。

　　必需组件可以这么理解：当活动组件（在组件窗格中被选择的组件）被安装时，你要添加组件到必须被安装的组件列表中或从该组件列表中删除组件。

其中控件有：

所需组件（列表框）：列出活动组件要求的组件。
组件（列表框）：列出所有定义的组件。活动组件有一个复选标记；所需组件有一个红圈和斜杠。
添加（按扭）：将在组件列表框中选定的组件添加到所需组件列表框中。
删除（按扭）：从所需列表框中删除选定的组件。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

·你可以通过使用资源编辑器拷贝 SdAskOptions 对话框资源（位于 _isres.dll ），对拷贝作有限的修改，并给它一个唯一 ID 来创建多个 SdAskOptions 类型的对话框。当你调用 SdAskOptions 并在参数 szId 传递对话框的自定义拷贝时，自定义拷贝被显示。限制对存在的静态文本区作编辑修改和增加静态文本区。不建议添加需要处理程序的控件，因为它需要改变 SdAskOptions 的资源脚本。

5.4 SdAskOptionsList

语法： SdAskOptionsList (szTitle, szMsg, szComponents, nStyle);

说明： SdAskOptionsList 函数创建一个对话框，显示一个自定义安装的组件列表。

SdAskOptionsList 运行在由系统变量 MEDIA 指定的当前媒体上。在安装的初始化中， InstallShield 给 MEDIA 赋缺省媒体名（" DATA "），它和你的文件媒体库（ Data1.cab ）相联系。为显示脚本创建的组件，按 4.6 中的相同步骤进行。

　　如果你的安装不使用一个安装类型对话框，你必须在调用 SdAskOptionsList 前调用 ComponentSetupTypeSet 来指定一个已经在 IDE 安装类型窗格中定义的安装类型。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件"），给该参数传递一个空字符串（ "" ）。

szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。

szComponents

指定要显示的包含子部件的组件名称。为显示所有顶层组件，给该参数传递一个空字符串。

SdAskOptionsList 在由系统变量 MEDIA 指定的文件媒体库或脚本创建组件组中查找所需的组件。

nStyle

指定最终用户的选择是否受限。在该参数位置传递下列预定义常量之一：

EXCLUSIVE ：允许最终用户仅从列表中选择一个项目。如果任何 szComponents' 的子部件是所需组件，则不使用 EXCLUSIVE 模式。

NONEXCLUSIVE ：允许最终用户从列表中选择多个项目，包括多个非邻接的选项。两个按钮被显示： Select All 和 Clear All, ，允许通过单击一个按钮选择所有选项或清除所有选项。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

5.5 SdBitmap

语法： SdBitmap (szTitle, szMsg, szBitmap);

说明： SdBitmap 函数在一个对话框中显示一个位图。位图所允许的最大大小是宽 440 个像素点、高 275 个像素点。仅当你使用一个资源编辑器来修改 SdBitmap 对话框资源使得显示消息的控件成为可见时，你才可以在 SdBitmap 对话框中显示一个消息，查看下面注解。

参数：

szTitle

指定对话框标题。为显示缺省标题（"欢迎"），给该参数传递一个空字符串（ "" ）。

szMsg

给该参数传递一个空字符串 ("") ，除非你使用一个资源编辑器修改 SdBitmap 对话框来显示一个消息，查看下面注解。

szBitmap

指定要显示的位图的文件名和一组位图属性（可选）。如果包括位图属性，传递给该参数的字符串必须如下格式化：

" 位图文件名；透明标志' 3-D 标志；背景颜色 "

位图文件名

指定位图文件名。如果文件名未限定（也就是说，如果它不包括一个驱动器指示符和路径）， InstallShield 在 SUPPORTDIR 查找该位图。

透明标志

指示是否透明显示位图。当该标志是 1 （真）时，该位图所有紫红色（ RGB 值： 255 ， 0 ， 255 ）部分都透明显示。该参数的缺省值是 0 （非透明）。

3-D 标志

指示是否要绕着包含位图的静态区的边缘增加一个 3-D 边框。缺省为０（非３ D 边框）。

背景色

指示作为静态文本区背景的颜色。注意该颜色仅当位图小于它所显示在的静态文本区或透明标志设置为 1 并且位图有透明区域时才会可见。背景色必须以 RGB 值表示，也就是三个由逗号分隔的数值型的值。

　　下面的例子将从 MyBitmap.bmp 文件显示位图，它位于 SUPPORTDIR 文件夹。该位图将被置于一个黑色背景上。它有一个 3-D 边框。该位图的任何紫红色的部分将被显示为背景色 - 黑色。

"MyBitmap.bmp;1;1;0,0,0"

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

·你可以使用一个资源编辑器来修改 SdBitmap 对话框资源，使得一个传递给参数 szMsg 的消息字符串在 SdBitmap 对话框中显示。

· SdBitmap 对话框资源包括在 _isres.dll 中。该资源包含一个静态文本控件，它接收由参数 szMsg 传递的字符串。然而，该静态文本控件缺省为在 SdBitmap 对话框中不可查看（在对话框下）。 SdBitmap 也使用一个静态文本控件显示位图图象。你可以调整位图图象静态文本控件的大小和移动消息静态文本控件进入对话框来查看。

改变位图图象静态文本控制的大小可能影响你位图图象的显示。位图图象必须足够小来避免当它被 SdBitmap 在位图图象静态文本控制置中时被剪切掉。

·该函数不支持透明位图。如果你以该函数来使用一个透明位图，透明部分将被正常显示。

· SdBitmap 不支持图元文件。

5.6 SdComponentDialog

语法： SdComponentDialog (szTitle, szMsg, svDir, szComponents);

说明：使用 SdComponentDialog 函数创建一个对话框。显示当前媒体上用户可以安装的的组件列表和每个组件将占用的磁盘空间。该函数和 SdComponentDialogAdv 相同。

目标目录可以使用 Browse 按钮来修改；在其它驱动器上的可用磁盘空间可以使用 Disk Space 按钮来检查。

SdComponentDialogt 运行在由系统变量 MEDIA 指定的当前媒体上。在安装的初始化中， InstallShield 给 MEDIA 赋缺省媒体名（" DATA "），它和你的文件媒体库（ Data1.cab ）相联系。为显示脚本创建的组件，按 4.6 中的相同步骤进行。

如果你的安装不使用一个安装类型的对话框，你必须在调用 SdComponentDialog 之前调用 ComponentSetupTypeSet 来指定一个已经在 IDE 安装类型窗格中定义的安装类型。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件"），给该参数传递一个空字符串（ "" ）。

szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。

svDir

指定缺省选定的文件夹名；返回最终用户选择的文件夹名。注意由 svDir 指定的目标文件夹不会自动赋给 TARGETDIR 或其它任何系统变量。如果它要被使用，为将 svDir 值提供给安装，你必须将它赋给 TARGETDIR 或一个脚本定义的变量。

szComponents

指定其子部件要被显示的组件名称。为显示所有主组件，给该参数传递一个空字符串 ("") 。

SdComponentDialog 在由系统变量 MEDIA 指定的文件媒体库或脚本创建组件组中查找所需的组件。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

·一个组件在被选定前，其大小都显示为 0 。一旦它已经被选定，它的实际大小被显示。

·若有必要，组件名被截尾来允许显示最大可能的组件大小。显示大小的必要空间依赖于最大组件大小本身（ 2GB ）、当前使用的组件大小选项、和用来在对话框显示组件信息的字体。组件大小选项由 DialogSetInfo 函数设置。

·一旦显示最大可能大小所需的空间被确定，若有必要，所有组件名均自动被截尾以适应剩余空间。这确保组件名不会覆盖组件大小。

·注意在这种方法下需要较少空间显示大小（或没有被选）的组件的名称仍然会被截尾。为了最大化执行并确保组件名完整显示，使组件名小于在组件对话中的有效空间。

·如果由 svDir 指定的缺省文件夹不存在于最终用户系统，除非最终用户按下 Browse 按钮并按下列步骤从选择文件夹对话框创建它，否则它不会被创建。因此，无论何时用户想在调用 ComponentTransferData( 必要时，它会创建文件夹 ) 前指定一个要使用的缺省文件夹，为了确定该文件夹是否存在，当 SdComponentDialog 返回时都必须调用 ExistDir 。如果不存在，调用 CreatDir 在最终用户系统上创建它。

·运行在静止方式 (silent mode ) 的安装，如果在调用 SdComponentDialog 前文件夹不存在，必须创建该新文件夹。这样可以确保确认对话框不被显示。没有这一步，需要两个响应文件来处理两个可能情况。

· Disk Space 按钮的 ID 是 101 。该按钮自动显示有效磁盘空间对话框。如果愿意你可以删除该按钮 / 选项。目录静态区需要一个 ID 为 851 。列表框 ID 有一个多选项风格。

5.7 SdComponentDialog2

语法： SdComponentDialog2 (szTitle, szMsg, szDir, szComponents);

说明： SdComponentDialog2 函数创建一个对话框，显示一个用户可以安装的当前媒体上的组件列表。显示在组件窗口中的组件可以有子部件。如果一个组件有子部件， Change 按钮将成为有效。单击 Change 按钮将生成选择子部件对话框，可以作进一步的选择。对每个组件和子部件，也提供说明。当用户选择或高亮显示组件时，其说明显示在对话框的说明区下。

SdComponentDialog2 运行在由系统变量 MEDIA 指定的当前媒体上。在安装的初始化中， InstallShield 给 MEDIA 赋缺省媒体名（" DATA "），它和你的文件媒体库（ Data1.cab ）相联系。为显示脚本创建的组件，按 4.6 中的相同步骤进行。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件"），给该参数传递一个空字符串（ "" ）

szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。

szDir

指定目标目录的名称（目标位置）。注意由 svDir 指定的目标文件夹不会自动赋给 TARGETDIR 或其它任何系统变量。如果它要被使用，为将 svDir 值提供给安装，你必须将它赋给 TARGETDIR 或一个脚本定义的变量。

szComponents

指定其子部件要被显示的组件名称。为显示所有主组件，给该参数传递一个空字符串 ("") 。

SdComponentDialog2 在由系统变量 MEDIA 指定的文件媒体库或脚本创建组件组中查找所需的组件。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

·一个组件在被选定前，其大小都显示为 0 。一旦它已经被选定，它的实际大小被显示。

·若有必要，组件名称被截尾来允许显示最大可能的组件大小。显示大小的必要空间依赖于最大组件大小本身（ 2GB ），当前使用的组件大小选项，和用来在对话框显示组件信息的字体。组件大小选项由 DialogSetInfo 函数设置。

·一旦显示最大可能大小所需的空间被确定，若有必要，所有组件名均自动被截尾以适应剩余空间。这确保组件名不会覆盖组件大小。

·注意在这种方法下需要较少空间显示大小（或没有被选）的组件的名称仍然会被截尾。为了最大化执行并确保组件名完整显示，使组件名小于在组件对话框中的有效空间。

·当且仅当被选定的组件有任何子部件时 Change 按钮才为有效。否则，它将变灰。

·如果一个组件被撤消选定，它的子部件也必须缺省为撤消选定。同样的，如果一个组件的所有子部件缺省为撤消选定，则父组件也必须缺省为撤消选定。有关组件和子部件的缺省选定设置请参考 ComponentAddItem 函数。

·当用户选定一个显示在对话框中的组件或子部件时，缺省选定设置被清除。如果用户撤消选定一个组件，所有它的子部件也将被撤消选定。如果用户撤消选定一个组件的所有子部件，该组件也将被撤消选定。

5.8 SdComponentDialogAdv

语法： SdComponentDialogAdv (szTitle, szMsg, svDir, szComponents);

说明：使用 SdComponentDialogAdv 函数创建一个对话框。显示当前媒体上用户可以安装的组件列表和每个组件将占用的磁盘空间。该函数和 SdComponentDialog 相同。

目标目录可以使用 Browse 按钮来修改：同时在其它驱动器上的可用磁盘空间可以使用 Disk Space 按钮来检查。

SdComponentDialogtAdv 运行在由系统变量 MEDIA 指定的当前媒体上。在安装的初始化中， InstallShield 给 MEDIA 赋缺省媒体名（" DATA "），它和你的文件媒体库（ Data1.cab ）相联系。为显示脚本创建的组件，按 4.6 中的相同步骤进行。

系统变量 MEDIA 的值在安装初始化过程中被设置为 'DATA' 。如果你改变该变量的值来指向一个脚本创建组件组，你必须在调用 ComponentTransferData, CreateShellObjects, 或 CreateRegistrySet. 前将值修改回 'DATA' 。注意运行一个基于事件的脚本的安装中， ComponentTransferData 被自动调用。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件"），给该参数传递一个空字符串（ "" ）。

szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。

svDir

szComponents

指定其子部件要被显示的组件名称。为显示所有主组件，给该参数传递一个空字符串 ("") 。

SdComponentDialogAdv 在由系统变量 MEDIA 指定的文件媒体库或脚本创建组件组中查找所需的组件。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

请参阅 5.7 。

5.9 SdComponentMult

语法： SdComponentMult (szTitle, szMsg, szTargetDir, szComponents);

说明： SdComponentMult 函数创建一个对话框，提供给最终用户一个选项来从当前媒体上的一个组件和子部件列表中选择。对话框有两个子窗口。如果被选定的组件有子部件，它们在第二个窗口中显示。对话框也显示所需的磁盘空间（依赖于被选定的组件和子部件）和目标目录的空闲磁盘空间来在安装过程中提供帮助。组件和 / 或子部件的说明可以通过单击它的名称在说明区中查看。

有关组件和子部件的详细情况请参阅 7.1 。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件"），给该参数传递一个空字符串（ "" ）

szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。

szTargetDir

指定将应用程序安装到的目标文件夹名。注意由 svTargetDir 指定的目标文件夹不会自动赋给 TARGETDIR 或其它任何系统变量。如果它要被使用，为将 svTargetDir 值提供给安装，你必须将它赋给 TARGETDIR 或一个脚本定义的变量。

szComponents

指定其子部件要被显示的组件名称。为显示所有主组件，给该参数传递一个空字符串 ("") 。

SdComponentMult 在由系统变量 MEDIA 指定的文件媒体库或脚本创建组件组中查找所需的组件。

太长不能适应选择窗口的组件名将被从右截尾以适应有效空间。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

请参阅 5.7 。

5.10 SdComponentTree

语法： SdComponentTree (szTitle, szMsg, szDir, szComponents, nLevel);

说明： SdComponentTree 函数显示一个对话框，它包含下列内容：

一个树形控件，最终用户可以在其中选定在他们系统上需要的组件和不选定在他们系统上不需要的组件。
选定组件的说明（组件属性说明文本）。
需要用来执行树形控件中指定的文件操作的磁盘空间，和由 szDir 指定路径的磁盘的有效空间。（所需磁盘空间的计算考虑在 szDir 指定的磁盘的簇的大小。）

SdComponentTree 运行在由系统变量 MEDIA 指定的当前媒体上。在安装的初始化中， InstallShield 给 MEDIA 赋缺省媒体名（" DATA "），它和你的文件媒体库（ Data1.cab ）相联系。为显示脚本创建的组件，按 4.6 中的相同步骤进行。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件"），给该参数传递一个空字符串（ "" ）。

szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。 szDir

指定在计算所需和有效磁盘空间中用到的磁盘的路径。

szComponents

指定其子部件要被显示的组件名称。为显示所有主组件，给该参数传递一个空字符串 ("") 。

nLevel

指定当对话框第一次被显示时在树形控件中打开多少层组件和子部件。（例如， nLevel 为 2 ，则对话框首次显示时，第三和更低层的子部件在树形控件中被关闭。）

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

5.11 SdConfirmNewDir

语法： SdConfirmNewDir (szTitle, szDir, nReserved);

说明： SdConfirmNewDie 函数创建一个对话框，显示一个文件夹名和一个确认的提示。如果最终用户单击 Yes 按钮，则一个新文件夹自动由该函数创建。

参数：

szTitle

指定对话框标题。为显示缺省标题（"确认新文件夹"），给该参数传递一个空字符串（ "" ）。

szDir

指定要确认的目录名称。（通过调用 SdAskDestPath 来得到该信息）

nReserved

给该参数传递 0 。不允许其它值。

返回值：

YES (1) ：表明单击了 Yes 按钮并且目录已经被确认并将被创建。

NO (0) ：表明单击了 No 按钮，并且指定的目录不会被创建。

<0 ：表明 Yes 被选定了但函数未能创建新目录。

5.12 SdConfirmRegistration

语法： SdConfirmRegistration (szTitle, szName, szCompany, szSerial, nReserved);

说明： SdConfirmRegistration 函数创建一个对话框，显示用户名、公司名称和序列号。如果在该对话框的任何区域输入一个空字符串（ "" ），显示的区域将为空。

参数：

szTitle

指定对话框标题。为显示缺省标题（"注册认可"），给该参数传递一个空字符串（ "" ）。

szName

指定最终用户姓名。

szCompany

指定公司名称。

szSerial

指定序列号。如果该参数包含一个空字符串（ "" ），序列号区不在对话框显示。

nReserved

给该参数传递 0 。不允许其它值。

返回值：

YES (1) ：表明单击 Yes 按钮。

NO (0) ：表明单击 No 按钮。

注解：

·为得到序列号和最终用户的姓名和公司名，调用 SdRegisterUserEx 。只要得到姓名和公司名，调用 SdRegisterUser 。

5.13 SdDisplayTopics

语法： SdDisplayTopics (szTitle, szMsg, listTopics, listDetails, nReserved);

说明： SdDisplayTopics 函数创建一个对话框，显示基于主题数据（资料）的信息。对话框提供一个标题然后是标题的主题和说明。你可以修改说明文本的字体风格以让它和标题（主题）文本想区别。消息和主题标题通常是粗体。可使用该对话框显示帮助主题、例子等。

参数：

szTitle

指定对话框标题。为显示缺省标题（"自定义安装帮助"），给该参数传递一个空字符串（ "" ）。

szMsg

指定对话框中显示的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串（ "" ）。

listTopics

指定要显示的包含主题的字符串列表。

listDetails

指定包含每个主题的说明的字符串列表。

nReserved

给该参数传递 0 。不允许其它值。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

·消息静态区必须以 801 为 ID 。主题标识符 ID 必须在 802-849 的范围之内。说明区 ID 必须在 851-899 的范围之内。

·静态说明区的空间由对话框的大小固定。你不能动态改变 listDetails 列表的空间。如果主题和说明的数目小于静态区的数目，在空白区不显示任何内容，但对话框大小不会改变。

5.14 SdExceptions

语法： SdExceptions (nExceptionType, szFilename);

说明： SdExceptions 函数显示一个对话框，通知最终用户遇到一个共享，锁定（在使用中）或只读的文件并提供适当的选项。

参数：

nExceptionType

指定遇到文件问题的类型。在该参数位置传递下列预定义常量之一：

SHARED ：一个共享的文件，其引用计数器已经减为 0 。

READONLY ：遇到一个只读文件。

LOCKED ：遇到一个锁定文件。

szFilename

指定遇到问题的文件名。

返回值：

ERR_RETRY (4) ：表明选定了 Retry 按钮。

ERR_IGNORE (5) ：表明选定了 Ignore 按钮。

ERR_YES (6) ：表明选定了 Yes 按钮。

ERR_NO (7) ：表明选定了 No 按钮。

ERR_PERFORM_AFTER_REBOOT (100) ：表明选定了 Reboot 按钮。

<0 ：表明对话框不能被显示。

5.15 SdFinish

语法： SdFinish (szTitle, szMsg1, szMsg2, szOpt1, szOpt2, bvOpt1, bvOpt2);

说明： SdFinish 函数显示一个对话框，通知最终用户安装已完成并给用户信息或选择。 SdFinish 对话框显示两个消息和两个复选框选择选项。例如，你可能想要提供给用户查看 README 文件或运行应用程序的选择。

为在消息中或复选框说明中插入产品名称，在 szMsg1, szMsg2, szOpt1, 和 szOpt2 传递的字符串中使用位置夹 %P 。

参数：

szTitle

指定对话框标题。为显示缺省标题（"安装完成"），给该参数传递一个空字符串（ "" ）。

szMsg1

指定在对话框顶端显示的消息。为显示通知用户安装完成的缺省指示，给该参数传递一个空字符串（ "" ）。

szMsg2

指定在对话框底部显示的消息。为显示缺省指示（"单击 Finish 按钮完成安装"），给该参数传递一个空字符串（ "" ）。

szOpt1

指定显示在第一个复选框旁边的文本。给该参数传递一个空字符串 ("") 来隐藏复选框。

szOpt2

指定显示在第二个复选框旁边的文本。给该参数传递一个空字符串 ("") 来隐藏复选框。

bvOpt1

返回第一个复选框的选择状态（ TRUE 或 FALSE ）。

bvOpt2

返回第二个复选框的选择状态（ TRUE 或 FALSE ）。

返回值：

NEXT (1) ：表明单击了 Finish 按钮。

注解：

· SdFinish 没有选项来终止安装和重启最终用户的计算机。当 SdFinish 返回时，安装继续执行。当有必要提供给用户重启的选项时，可用调用 SdFinishReboot 来代替。

·因为 SdFinish 被设计为宣告安装结束，所以 Back 按钮被禁用。

5.16 SdFinishEx

语法： SdFinishEx (szTitle, szMsg1, szMsg2, szOpt1, szOpt2, bvOpt1, bvOpt2);

说明： SdFinishEx 函数调用 SdFinish 或 SdFinishReboot 来显示一个对话框，通知最终用户安装已完成并给用户信息或选择。如果系统变量 BATCH_INSTALL 等于 FALSE （表明安装过程中没有遇到锁定文件）， SdFinishEx 调用 SdFinish 来显示对话框。如果 BATCH_INSTALL 等于 TRUE ， SdFinishEx 调用 SdFinishReboot 来显示对话框。

为在消息中或复选框说明中插入产品名称，在 szMsg1, szMsg2, szOpt1, 和 szOpt2 传递的字符串中使用位置夹 %P 。

参数：

参数和 SdFinish 的相同。如果 BATCH_INSTALL 等于 TRUE ，这些参数被忽略并调用 SdFinishReboot("","",SYS_BOOTMACHINE,"",0) 。

返回值：

0 ：表明调用了 SdFinish 。

NEXT (1) ：表明调用 SdFinishReboot 并且最终用户不重启计算机。

<0 ：表明调用 SdFinishReboot 并且最终用户选择重启计算机，但重启失败。

5.17 SdFinishReboot

语法： SdFinishReboot (szTitle, szMsg1, nDefOption, szMsg2, nReserved);

说明： SdFinishReboot 函数在你的安装结尾宣告安装完成并提供给用户重启系统的选项。重启系统允许修改 Autoexec.bat,Config.sys 和一些 .ini 文件使其起作用。

SdFinishReboot 对话框在静态文本区中显示两个消息。用参数 szMsg1 和 szMsg2 来设置这些区域的值。为在消息中或复选框说明中插入产品名称，在 szMsg1 和 szMsg2 传递的字符串中使用位置夹 %P 。

参数：

szTitle

指定对话框标题。为显示缺省标题（"安装完成"），给该参数传递一个空字符串（ "" ）。

szMsg1

指定在对话框顶端显示的消息。为显示通知用户安装完成的缺省指示，给该参数传递一个空字符串（ "" ）。

nDefOption

指定一个缺省单选按钮选项选择。在该参数位置传递下列预定义常量之一：

SYS_BOOTMACHINE ：安装结束时重启计算机。

0 ：不重启计算机。 .

szMsg2

指定显示在对话框底部的文本，提供用户要做什么的信息。为显示缺省指示，传递一个空字符串（ "" ）。

nReserved

给该参数传递 0 。不允许其它值。

返回值：

WILL_REBOOT ：表明用户选择重启系统。

NEXT (1) ：表明用户没有选择重启系统或 Windows 。

<0 ：表明用户选择重启系统或 Windows ，但重启失败。

注解：

·因为当其它 InstallShield 实例运行时， InstallShield 将尽力不重启计算机，所以你必须在允许 SdFinishReboot 重启 Windows 或系统前关闭所有其它 InstallShield 实例。另外，你给用户的消息必须要求他们以后若要重启系统，则他们必须确保首先关闭所有其它的应用程序。

· InstallShield 自动确保锁定的 .dll 和 .exe 文件在下一次系统启动时将被更新。

·因为 SdFinishReboot 被设计为宣告安装结束，所以 Back 按钮被禁用。

5.18 SdInit

语法： SdInit ( );

说明： SdInit 函数准备一个调用 Sd 对话框函数的安装：装入所需的资源字符串，还原最小化的 InstallShield 窗口，并指定在 Sd 对话框中 Windows 95 风格的复选框。

参数：

该函数没有参数。

返回值：

0 ：表明安装为调用 Sd 对话框函数作好初始化。

1 ：表明为调用 Sd 对话框函数，安装已经被初始化。

注解：

·该函数由每个 Sd 函数自动调用。没有必要显式调用 SdInit ，除非你的脚本在调用任何 Sd 对话框函数前调用了 DialogSetInfo 。这种情况下，你的脚本必须在调用 DialogSetInfo 前调用 SdInit ；否则对 DialogSetInfo 的调用不起任何作用。

5.19 SdLicense

语法： SdLicense (szTitle, szMsg, szQuestion, szLicenseFile);

说明： SdLicense 函数显示一个对话框，包含一个在多行编辑区的许可证协议。许可证协议保存在一个由参数 szLicenseFile 指定的文本文件中。

用户可以上下滚动来阅读协议，然后必须选择 Yes 、 No 或 Enable 、 Back 按钮。因为这可能是你将显示的第一个对话框，你可能要禁止 Back 按钮。如果用户选择了 Yes ，安装将继续。如果用户选择了 No,InstallShield 将显示退出安装对话框。

参数：

szTitle

指定对话框标题。为显示缺省标题（"软件许可证协议"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在多行编辑区上方的静态文本区中的消息。为显示缺省指示，传递一个空字符串。

szQuestion

指定显示在多行编辑区下方的静态文本区中的文本。你可能在这儿放置一个问题，用户必须选择 Yes 或 No 来响应它。为显示缺省指示，给该参数传递一个空字符串 ("") 。

szLicenseFile

指定包含许可证协议的文本文件名。该文件必须被加到安装文件窗格中适当语言文件夹中。

返回值：

YES (1) ：表明用户选择了 Yes 按钮。

BACK (12) ：表明用户选择了 Back 按钮。

注解：

·该函数不能返回 NO ，因为，如果用户选择了 No 按钮，将显示退出安装对话框。

·你也可以通过输入全限定名，在引号中，或一个 Universal Naming Convention (UNC) 路径来指定 szLicenseFile 。

·在 szLicenseFile 中的文本在超过 1024 个字符的一行后必须包含硬回车。该文件的文本必须以 1024 字节为间隔读入字符串列表。如果从 szLicenseFile 的文本不包含硬回车，单词会在 SdLicense 对话框中意外地回绕。

5.20 SdLoadString

语法： SdLoadString (nID);

说明： SdLoadString 函数返回与指定的资源 ID 相联系的字符串值。安装引擎首先在 _isuser.dll （如果该文件存在）中查找资源；如果资源没有找到，安装引擎在 _isres.all 中查找。

参数：

nID

指定一个在 _isuser.dll 或 _isres.dll 中的字符串资源的标识符。一些 nID 的有效值可以在 InstallShield Professional 文件夹的 Script\Ifx\Include 的子文件夹的 Ifx.h 文件中找到。

返回值：

非空字符串值

SdLoadString 成功检索到字符串值。

空字符串值 ("")

表明 SdLoadString 失败。

5.21 SdMakeName

语法： SdMakeName (svSection, szDlg, szUnused, nvDlgName);

说明： SdMakeName 函数为一个自定义对话框创建一个节名。该节名在写到一个 .iss 文件或从中读出时被使用，由 InstallShiled Silent 使用。

参数：

svSection

指定节名（ InstallShield 使用变量 szDlg 和 nvDlgName 来给该变量置一个值）。该值由 SilentReadData 和 SilentWriteData. 使用。

szDlg

指定自定义对话框的名称。

szUnused

该参数不使用，给它传递一个空字符串 ("") 。

nvDlgName

指定记录 SdMakeName 被由 szDlg 命名的对话框调用的次数的计数器。 InstallShield 自动增加该计数器。为每个自定义对话框使用一个唯一的变量名。（可参阅下面的注解）

返回值：无。

注解：

·为使节被适当命名，你必须在每个不同的自定义对话框的第四个参数使用一个唯一的变量名。做到这一点的简单方法是在 szDlg 使用对话框名来命名该变量。例如，当 szDlg 是" MyDlgOne", 命名在第四个参数的变量为 nvMyDlgOne ；当 szDlg 是" MyDlgTwo "，命名该变量为 nvMyDlgTwo 。

5.22 SdOptionsButtons

语法： SdOptionsButtons (szTitle, szMsg, listButtons, listDescription);

说明： SdOptionsButtons 函数显示一个对话框，包含一到四个位图按钮和一个简短的对每个按钮的文本说明。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择组件"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。为显示该对话框缺省指示（"请选择你要安装的组件"），给该参数传递一个空字符串（ "" ）。

listButtons

指定一个包含一到四个元素的字符串列表。每个元素是一个格式化的指定显示在按钮上的位图的字符串。一个按钮将被用来显示列表中的每个字符串元素。字符串列表元素必须有下列格式：

"@< 位图 ID>;< 位图图标标志 >;< 透明颜色 >"

由 @ 符号开始字符串并后随位图 ID 。 < 位图图标标志 > 域是 1 （真）或 0 （假），表明位图被显示时在 < 透明颜色 > 域指定的颜色是否要透明显示。 < 透明颜色 > 域指定一个 RGB 值，它是位图的透明颜色。注意分号将 ID 和图标标志、图标标志和透明颜色分隔。

更多的信息可参阅下面的注解部分。

listDescription

指定一个包含一到四个字符串元素的字符串列表，每个相对应于参数 listButtons 中的一个字符串。每个字符串是一个和它相应按钮一起显示的文本说明。

返回值：

NEXT (1) ：表明单击了 NEXT 按钮。

BACK (12) ：表明单击了 Back 按钮。

101 ：对应于 listButtons 中的第一个字符串元素的按钮被选定。

102 ：对应于 listButtons 中的第二个字符串元素的按钮被选定。

103 ：对应于 listButtons 中的第三个字符串元素的按钮被选定。

104 ：对应于 listButtons 中的第四个字符串元素的按钮被选定。

注解：

·虽然 SdOptionsButtons 可以被使用为一个安装类型对话框，但还是推荐使用 SdSetupTypeEx 对话框来允许最终用户选择一个安装类型，因为它不需要任何用户化。注意如果你调用 SdOptionsButtons 来得到最终用户的安装类型选择，你必须然后调用 ComponentButtons 来为你的安装建立选择的安装类型。

· InstallShield 提供可以被该函数调用的四个 _isres.dll 中的缺省位图。这些位图有从 12001 到 12004 的 ID 和在脚本范例中相应的典型、可移植、简易和自定义安装类型。

·如果你使用该对话框作其它用途或你想要使用 _isres.dll 中提供的类型之外的安装类型，你必须将你自己的自定义按钮加入到 _isuser.dll 对话框模板中并且然后在你的安装中包含自定义的 _isuser.dll 。

·为防止用户没有单击一个特定按钮时就退出对话框，在你调用 SdOptionsButtons 前调用 Disable 函数来禁止 Next 按钮。

5.23 SdProductName

语法： SdProductName (szProductName);

说明： SdProductName 函数使得你的产品名对所有的 %P 位置夹都有效。 %P 位置夹在一些 Sd 对话框中的静态文本区中找到。另外，一些 Sd 对话框函数，如 SdFinish ，允许你在作为函数参数的字符串中包含 %P 。

参数：

szProductName

指定被安装的产品名。该名称将取代在 Sd 对话框的适当静态区出现的任何产品名位置夹（ %P ）。

返回值：

该函数没有返回值。

5.24 SdRegisterUser

语法： SdRegisterUser (szTitle, szMsg, svName, svCompany);

说明： SdRegisterUser 函数创建一个对话框，检索用户姓名和公司名称。如果 svName 和 svCompany 都包含空字符串， InstallShield 将从注册表中得到用户姓名和公司名称。

仅当两个编辑区都存在数据时 Next 按钮才被激活。如果 InstallShield 可以从系统查找缺省姓名和公司名称， Next 按钮被自动激活。完成时， SdRegisteruser 调用 RegDBSetDefaultRoot 来将注册表开关键设置给 HKEY_CLASSES_ROOT 。

参数：

szTitle

指定对话框标题。为显示缺省标题（"用户信息"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。该文本被看作为一个静态控制。为显示该对话框缺省指示，给该参数传递一个空字符串（ "" ）。

svName

返回由用户输入的姓名。注意 SdRegisterUser 显示该参数的初始值由用户进行编辑。如果 svName 和 svCompany 都是空字符串，在目标系统注册表中被找到的用户姓名将被显示来进行编辑。

svCompany

返回由用户输入的公司名称。注意 SdRegisterUser 显示该参数的初始值由用户进行编辑。如果 svName 和 svCompany 都是空字符串，在目标系统注册表中被找到的公司名称将被显示来进行编辑。

返回值：

NEXT (1) ：表明单击了 NEXT 按钮。

BACK (12) ：表明单击了 Back 按钮。

5.25 SdRegisterUserEx

语法： SdRegisterUserEx (szTitle, szMsg, svName, svCompany, svSerial);

说明： SdRegisterUserEx 函数创建一个对话框，检索用户姓名、公司名称和序列号。如果 svName 和 svCompany 都包含空字符串， InstallShield 将从注册表得到用户姓名和公司名称。

仅当三个编辑区都存在数据时 Next 按钮才被激活。你不能让任何区域空白。

完成时， SdRegisteruser 调用 RegDBSetDefaultRoot 来将注册表开关键设置给 HKEY_CLASSES_ROOT 。

参数：

szTitle

指定对话框标题。为显示缺省标题（"用户信息"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。该文本被看作为一个静态控件。为显示该对话框缺省指示，给该参数传递一个空字符串（ "" ）。

svName

返回由用户输入的姓名。注意 SdRegisterUserEx 显示该参数的初始值由用户进行编辑。如果 svName 和 svCompany 都是空字符串，在目标系统注册表中被找到的用户姓名将被显示来进行编辑。

svCompany

返回由用户输入的公司名称。注意 SdRegisterUserEx 显示该参数的初始值由用户进行编辑。如果 svName 和 svCompany 都是空字符串，在目标系统注册表中被找到的公司名称将被显示来进行编辑。

svSerial

返回用户输入的序列号。你可以使用该信息并把它写入一个文件或者把它显示在一个确认对话框中。

返回值：

NEXT (1) ：表明单击了 NEXT 按钮。

BACK (12) ：表明单击了 Back 按钮。

5.26 SdSelectFolder

语法： SdSelectFolder (szTitle, szMsg, svDefGroup);

说明： SdSelectFolder 函数显示供选择的程序文件夹。 SdSelectFolder 允许你提供一个缺省选择。用户也可以输入一个新的文件夹名。 SdSelectFolder 将仅返回被选择的或输入的文件夹名。它不能创建文件夹。

参数：

szTitle

指定对话框标题。为显示缺省标题（"选择程序文件夹"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。该文本被看作为一个静态控件。为显示该对话框缺省指示，给该参数传递一个空字符串（ "" ）。

svDefGroup

返回被选文件夹的名称。

返回值：

NEXT (1) ：表明单击了 NEXT 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

·运行在 Windows NT 下的一个安装中，如果在调用 SdSelectFolder 前调用 ProgDefGroup ，由 SdSelectFolder 显示的程序文件夹（公用或专用）将依赖于传递给 ProgDefGroupType 的参数。

5.27 SdSetupType

语法： SdSetupType (szTitle, szMsg, svDir, nReserved);

说明： SdSetupType 函数显示一个对话框允许最终用户选择三种标准安装类型之一：典型、简易或自定义。这些安装选项显示时有标准描述文本。如果你想加入其它安装类型或改变显示的安装类型名或描述，调用 SdSetupTypeEx 来替代。

对话框也显示一个缺省的目标路径。一个 Browse 按钮装入一个对话框，允许最终用户通过输入一个新文件夹名或从一个列表中选择存在的文件夹来修改目标路径。如果最终用户输入一个不存在的文件夹名，将显示一个消息框来询问是否要创建该文件夹。如果最终用户单击 Yes ，该函数自动创建指定文件夹。指定文件夹的全限定路径在 svDir 返回。

如果最终用户在使用组件对话框来选定和撤消选定与已选安装类型相联系的组件后，返回到安装类型对话框，那么那些选择将丢失。这种情况发生是因为 SdSetupType 函数每次被调用时自动根据选中的安装类型复位缺省组件选项。

参数：

szTitle

指定对话框标题。为显示缺省标题（"安装类型"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。该文本被看作为一个静态控件。为显示该对话框缺省指示，给该参数传递一个空字符串（ "" ）。

svDir

指定一个缺省文件夹名。返回最终用户所选的文件夹名。

nReserved

保留为将来使用。给该参数传递 0 。

返回值：

TYPICAL (301) ：表明用户选择典型安装。

COMPACT (302) ：表明用户选择简易安装。

CUSTOM (303) ：表明用户选择自定义安装。

BACK (12) ：表明单击 Back 按钮。

5.28 SdSetupTypeEx

语法： SdSetupTypeEx (szTitle, szMsg, szReserved, svSetupType, nReserved);

说明： SdSetupTypeEx 函数显示一个对话框，当你指定除典型、简易和自定义之外的安装类型时，允许最终用户选择安装类型。

参数：

szTitle

指定对话框标题。为显示缺省标题（"安装类型"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。为显示该对话框缺省指示，给该参数传递一个空字符串（ "" ）。

szReserved

给该参数传递一个空字符串 ("") 。不允许其它值。

svSetupType

指定一个缺省安装类型和返回由最终用户选择的安装类型。为使在列表中的第一次安装为缺省选择，给该参数传递一个空字符串 ("") 。在该参数返回的字符串将和在 IDE 中指定的安装类型名相匹配。

nReserved

给该参数传递 0 。不允许其它值。

返回值：

0 ：表明 SdSetupTypeEx 成功。

BACK (12) ：表明单击了 Back 按钮。

5.29 SdShowAnyDialog

语法： SdShowAnyDialog (szTitle, szID, nID, nReserved);

说明： SdShowAnyDialog 函数显示一个自定义或改进型对话框。该函数仅推荐给高级用户使用。

参数：

szTitle

指定对话框标题。为显示缺省标题（"欢迎"），给该参数传递一个空字符串（ "" ）。

szID

指定标识对话框的标识符字符串。如果该参数包含一个空字符串 ("") ， SdShowAnyDialog 使用 nID 的值。

nID

指定标识对话框的数值型值。如果 szID 包含一个空字符串 ("") ，该参数被忽略。

nReserved

给该参数传递 0 。不允许其它值。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

·为了使用 SdShowAnyDialog 函数，你必须知道你希望显示的 _isres.dll 中的改进型对话框或 _isuser.dll 中的自定义对话框的 ID 。

·如果对话框只有静态控件，你不需要修改 SdShowAnyDialog 脚本文件。但如果你的对话框有其它控件，为了处理用户的反馈，你必须修改 Sdsadlg.rul 文件，位于你的 InstallShield 程序文件夹中的 Script/Srt 文件夹 ,

5.30 SdShowDlgEdit1

语法： SdShowDlgEdit1 (szTitle, szMsg, szField1, svEdit1);

说明： SdShowDlgEdit1 函数创建一个通用对话框，显示一个消息和一个单行编辑区。你可以为该对话框指定一个标题。

参数：

szTitle

指定对话框标题。为显示缺省标题（"编辑数据"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。为在该消息包含由先前调用 SdProductName 设置的产品名称，在该消息的任何地方插入位置夹 %P 。当消息被显示时， %P 由产品名称代替。

szField1

指定显示在编辑区左边的域名。缺省的域名是"域 1 ："；为显示缺省名称，给该参数传递一个空字符串 ("") 。可以被显示的字符数最大约为 10 。实际的最大值依赖于域名中每个字符的组合宽度。如果域名超出有效空间，则当对话框被显示时它将从右被截尾。

svEdit1

指定编辑区的初始值；当对话框被关闭时，返回编辑区的值。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

5.31 SdShowDlgEdit2

语法： SdShowDlgEdit2 (szTitle, szMsg, szField1, szField2, svEdit1, svEdit2);

说明： SdShowDlgEdit2 函数创建一个通用对话框，显示一个消息和两个单行编辑区。你可以为该对话框指定一个标题。

参数：

szTitle

指定对话框标题。为显示缺省标题（"编辑数据"），给该参数传递一个空字符串（ "" ）。

szMsg

szField1

指定显示在第一个编辑区左边的域名。缺省的域名是"域 1 ："；为显示缺省名称，给该参数传递一个空字符串 ("") 。可以被显示的字符数最大约为 10 。实际的最大值依赖于域名中每个字符的组合宽度。如果域名超出有效空间，则当对话框被显示时它将从右被截尾。

szField2

为第二个编辑区指定域名。缺省为"域 2 ："。

svEdit1

指定第一个编辑区的初始值；当对话框被关闭时，返回第一个编辑区的值。

svEdit2

指定第二个编辑区的初始值；当对话框被关闭时，返回第二个编辑区的值。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

5.32 SdShowDlgEdit3

语法： SdShowDlgEdit3 (szTitle, szMsg, szField1, szField2, szField3, svEdit1, svEdit2, svEdit3);

说明： SdShowDlgEdit2 函数创建一个通用对话框，显示一个消息和三个单行编辑区。你可以为该对话框指定一个标题。

参数：

szTitle

指定对话框标题。为显示缺省标题（"编辑数据"），给该参数传递一个空字符串（ "" ）。

szMsg

szField1

szField2

为第二个编辑区指定域名。缺省为"域 2 ："。

szField3

为第二个编辑区指定域名。缺省为"域 2 ："。

svEdit1

指定第一个编辑区的初始值；当对话框被关闭时，返回第一个编辑区的值。

svEdit2

指定第二个编辑区的初始值；当对话框被关闭时，返回第二个编辑区的值。

svEdit3

指定第三个编辑区的初始值；当对话框被关闭时，返回第三个编辑区的值。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

5.33 SdShowFileMods

语法： SdShowFileMods (szTitle, szMsg, szTargetFile, szAltFile, listChanges, nvSelection);

说明： SdShowFileMods 函数创建一个对话框，显示你想要对一个文件进行的修改。下面这些选择是有效的：

修改目标文件。
修改替代文件，它是目标文件的拷贝，但非联合修改。
不作任何修改。 SdShowFileMods 不对文件作修改。你必须使用适当的文件函数把那些修改写入你的脚本。

参数：

szTitle

指定对话框标题。为显示缺省标题（"修改文件"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串 ("") 。

szTargetFile

指定要修改的文件名。它将和第一个单选按钮一起显示。

szAltFile

如果最终用户决定要作修改，指定该文件的替代名。这将和第二个单选按钮一起显示。为使用 sztargetFile 指定的扩展名为 .bak 的文件名，给该参数传递一个空字符串（ "" ）。

listChanges

指定字符串列表名，它包含对文件所作修改的列表。该列表位于一个多行编辑区，允许最终用户选择要实现的修改。

nvSelection

返回最终用户选择的按钮的 ID ：

101 ： "让安装修改 <szTargetFile> 文件。"

102 ： "保存对 <szAltFile> 所要求的修改。"

103 ： "不作任何修改。"

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

5.34 SdShowInfoList

语法： SdShowInfoList (szTitle, szMsg, listID);

说明： SdShowInfoList 函数创建一个对话框，显示一个可滚动的消息列表。

参数：

szTitle

指定对话框标题。为显示缺省标题（"信息"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在信息框上方一行的消息。如果消息长于一行，将被从右截尾。如果消息包含一个换行符 (\n) ，换行符后的文本不被显示。为显示缺省消息（ "Text" ），给该参数传递一个空字符串 ("") 。

listID

指定显示在对话框的消息列表。所有显示在对话框的消息为只读。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

BACK (12) ：表明单击了 Back 按钮。

注解：

·多行编辑区必须为只读。

· SdShowInfoList 可以显示大约多达 57200 个字符的列表。

5.35 SdShowMsg

语法： SdShowMsg (szMsg, bShow);

说明： SdShowMsg 函数打开或关闭一个小的非模态窗口，显示由 szMsg 指定的消息。当 bShow 为 TRUE ，窗口被打开，消息显示在窗口中，并且继续脚本中下一个语句的处理。注意 SdShowMsg 窗口被置于安装窗口的中央。当 bShow 为 FALSE 时， szMsg 被忽略并且关闭 SdShowMsg 窗口。

参数：

szMsg

指定显示在窗口的消息。为显示缺省消息 (" 安装正查找已安装的组件 ") ，给该参数传递一个空字符串 ("") 。当 bShow 为 FALSE 时该参数被忽略。

bShow

指定是否要打开或关闭窗口。在该参数位置传递下列预定义常量之一：

TRUE ：如果窗口没有打开则打开它。

FALSE ：如果窗口打开了则关闭它。

返回值：

返回值总为 0 。

注解：

· SdShowMsg 函数提供了一个简单方法使得脚本进程继续的同时，可以将一个显示丰富资料的消息保留在屏幕上。

·当 SdShowMsg 窗口是打开的，随后的对 SdShowMsg （第二个参数为 TRUE ）的调用被忽略。为改变消息，你必须首先以第二个参数为 FALSE 调用 SdShowMsg 来关闭窗口，然后以第二个参数为 TRUE ， szMsg 为新的消息再次调用 SdShowMsg 。

· SdShowMsg 窗口水平调整大小来在一行上显示 szMsg 的值。如果消息的长度超过窗口的最大宽度，消息被截尾以适应窗口。

· SdShowMsg 被设计为单行显示消息。不要在 szMag 中嵌入换行符 (\n) 。

5.36 SdStartCopy

语法： SdStartCopy (szTitle, szMsg, listData);

说明： SdStartCopy 函数创建一个多行编辑区，显示安装过程中所作的设置和选择。为按需改变设置，用户可以单击对话框的 Back 按钮来返回到以前的对话框。在检索用户的选择后，开始文件传输处理之前调用 SdStartCopy 。

使用一个字符串列表来收集安装过程中得到的信息。然后你可以将该字符串列表传递给 SdStartCopy 的参数 listData 。 SdStartCopy 将显示该列表并允许用户在继续文件传输处理之前确认这些信息是正确的。

参数：

szTitle

指定对话框标题。为显示缺省标题（"开始拷贝文件"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在多行编辑区上方的静态文本区的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串 ("") 。

listData

指定从最终用户检索得的信息字符串列表。 SdStartCopy 会自动将每个元素放置到多行编辑区。如果列表为空，该多行编辑区将被隐藏并且只有静态文本区为可见。

返回值：

NEXT (1) ：表明用户选定了 Next 按钮。

BACK (12) ：表明用户选定了 Back 按钮。

5.37 SdWelcome

语法： SdWelcome (szTitle, szMsg);

说明： SdWelcome 函数显示一个对话框，欢迎最终用户。

参数：

szTitle

指定显示在对话框标题部分的文本。为显示缺省标题（"欢迎"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在欢迎对话框中的消息。为在该消息中包含先前调用 SdProductName 而设置的产品名称，在该消息的任意位置插入一个位置夹 %P 。当该消息被显示时， %P 被产品名称代替。为显示缺省欢迎消息（"欢迎进入 %P 安装程序。该程序将在你的计算机上安装 %P "），给该参数传递一个空字符串 ("") 。

返回值：

NEXT (1) ：表明单击了 Next 按钮。

5.38 SdWelcomeMaint

语法： SdWelcomeMaint (szTitle, szMsg, nType);

说明： SdWelcomeMaint 函数显示一个对话框，在一个维护型安装（也就是，一个已经被运行的安装的重运行）的开始时使用。该对话框包含修改、修复、删除选项按钮。

参数：

szTitle

指定对话框标题。为显示缺省标题（"欢迎"），给该参数传递一个空字符串（ "" ）。

szMsg

指定显示在对话框的消息。为显示该对话框的缺省指示，给该参数传递一个空字符串 ("") 。

nType

指定哪个选项按钮为缺省选择。你必须在该参数位置传递下列预定义常量之一，使在对话框中正确显示：

MODIFY ：修改按钮为缺省选择。

REPAIR ：修复按钮为缺省选择。

REMOVEALL ：删除按钮为缺省选择。

返回值：

MODIFY (301) ：表明当单击 Next 按钮后修改按钮被选定。

REPAIR (302) ：表明当单击 Next 按钮后修复按钮被选定。

REMOVEALL (303) ：表明当单击 Next 按钮后删除按钮被选定。

6 自定义对话框函数

下列函数处理自定义对话框进程。你使用一个资源编辑器来创建对话框并可用这些函数把它插入脚本中。

任何你可以创建的 Windows 对话框都可以被使用在一个安装脚本中。对话框可以有单行或多行编辑框，单个或多个选择列表框，组合框，单选钮，复选框和下按按扭作为标准控件。对于更复杂的控件，则提供高级函数，如 CmdGetHwndDlg, LOWORD 和 HIWORD 。

CmdGetHwndDlg

检索一个对话框的句柄。

CtrlClear

删除一个编辑、静态、列表框或组合框控件。

CtrlDir

用一个目录列表或一个文件列表来填充一个列表框或组合框。

CtrlGetCurSel

从一个列表框或组合框中选择项目。

CtrlGetMLEText

从一个多行编辑或静态区域中检索文本。

CtrlGetMultCurSel

从一个多选列表框中返回选定项目。

CtrlGetState

从一个对话框中检索一个单选扭，复选框或下按按扭控件的状态。

CtrlGetSubCommand

检索在一个 WaitOnDialog 函数调用后对控件执行的操作。

CtrlGetText

从一个编辑区，一个静态区或一个组合框的编辑区中检索文本。

CtrlPGroups

检索在目标系统上存在的程序组列表。

CtrlSelectText

选择显示在一个编辑区中文本。

CtrlSetCurSel

在一个列表框或组合框中查找和设置当前选择。

CtrlSetFont

指定对话框中一个控件的字体。

CtrlSetList

把一个列表的内容放至一个列表框或组合框中。

CtrlSetMLEText

设置在一个多行编辑区中的文本。

CtrlSetMultCurSel

设置在一个多选列表框中的当前选择。

CtrlSetState

设置一个复选框，单选钮或下按按扭的当前状态。

CtrlSetText

设置在一个编辑区，一个静态文本区或一个组合框的编辑区中的文本。

DefineDialog

用 InstallShield 注册一个自定义对话框。

EndDialog

关闭一个自定义对话框。

EzDefineDialog

用 InstallShield 注册一个自定义对话框。

GetFont

检索一个字体的处理程序。

HIWORD

从一个 32 位的整数中检索高位字。

LOWORD

从一个 32 位的整数中检索低位字。

ReleaseDialog

释放一个对话框的关联内存。

SdMakeName

SdMakeName 为一个自定义对话框创建一个节名。该节名在向一个 .iss 文件写或从一个 .iss 文件中读时使用， .iss 文件由 InstallShield Silent 使用。

SilentReadData

指示 InstallShield Silent 为一个自定义对话框读取 .iss 文件对话数据。

SilentWriteData

指示 InstallShield Silent 为一个自定义对话框写对话数据到 .iss 文件。

WaitOnDialog

显现一个自定义对话框。

6.1 CmdGetHwndDlg

语法： CmdGetHwndDlg (szDialogName);

说明： CmdGetHwndDlg 函数检索由 szDialogName 标识的对话框的窗口句柄。该对话框必须已经由 EzDefineDialog ( 或 DefineDialog) 定义，并以通过调用 WaitOnDialog 而被初始化。

参数：

szDialogName

指定已经由 EzDefineDialog ( 或 DefineDialog) 定义的对话框的名称。

返回值：

> 0 ：由 szDialogName 指定的对话框的窗口句柄。

< 0 ： CmdGetHwndDlg 未能检索到句柄。请确认 szDialogName 指向的是一个已经正确定义并已被初始化的对话框。

注解：

·当一个对话框用 WaitOnDialog 函数初始化时，则为它分配一个窗口句柄；该句柄只和该对话框关联，直到一个对 EndDialog 的调用来关闭该对话框。如果你调用 WaitOnDialog 来打开在你脚本中先前已经被打开和关闭的一个对话框，你必须再次调用 CmdGetHwndDlg 来得到新句柄。老的句柄不再有效。

·通常， CmdGetHwndDlg 在一个自定义对话框的 DLG_INIT 例程中被调用。该对话框的句柄被赋给 HWND 变量来供其它需要它的函数使用。

6.2 CtrlClear

语法： CtrlClear (szDialogName, nControlID);

说明： CtrlClear 函数清除各种控件的内容；它删除一个自定义对话框中一个单行或多行编辑区，静态文本区，单或多选列表框或一个组合框的编辑区的内容。

参数：

szDialogName

指定包含有要被删除控件的对话框的名称。

nControlID

指定由 szDialogName 标识的对话框的控件 ID 。

返回值：

0 ： CtrlClear 成功删除指定控件的内容。

< 0 ： CtrlClear 未能删除对话框的内容。

6.3 CtrlDir

语法： CtrlDir (szDialogName, nControlID, szDir, nItems);

说明： CtrlDir 函数用一个与 szDir 指定的路径或文件名相匹配的文件列表来填充一个列表框或一个组合框控件。你可以在列表中包括文件名，子目录名和磁盘驱动器名。 CtrlDir 函数仅工作于自定义对话框。

参数：

szDialogName

指定一个对话框的名称。

nControlID

指定列表框或组合框控件的资源 ID 。

szDir

指定全限定路径或全限定文件名，可以包括通配符。

nItems

指定在控件中显示的列表的类型。在该参数位置传递下列预定义常量之一。为包含多个元素类型，将这些常量用按位或操作符 (|) 组合起来：

DLG_DIR_FILE ：创建一个与文件说明 szDir 匹配的文件的列表。

DLG_DIR_DIRECTORY ：创建一个存在于路径说明 szDir 中的子目录的列表。

DLG_DIR_DRIVE ：创建一个驱动器列表。

返回值：

0 ： CtrlDir 成功填充一个对话框中指定的控件。

< 0 ： CtrlDir 未能填充指定控件。

6.4 CtrlGetCurSel

语法： CtrlGetCurSel (szDialogName, nControlID, svText);

说明： CtrlGetCurSel 函数从一个自定义对话框中的一个单选列表框或组合框控件中检索当前选定的项目。调用 CtrlGetMultCurSel 来从多选列表框中检索项目。

参数：

szDialogName

指定包含要被检索的项目的自定义对话框的名称。

nControlID

指定单选框或组合框控件的资源 ID 。

svText

返回 nControlID 指定的控件中当前被选定的项目。

返回值：

0 ： CtrlGetCurSel 成功检索对话框中当前被选定的项目。

< 0 ： CtrlGetCurSel 未能检索被选定的项目。

6.5 CtrlGetMLEText

语法： CtrlGetMLEText (szDialogName, nControlID, listID);

说明： CtrlGetMLEText 函数检索一个自定义对话框中一个多行编辑控件的内容。 InstallShield 把多行编辑区中的每行放到由 listID 标识的一个字符串列表中。调用 CtrlGetText 来检索一个单行编辑区控件的内容。

参数：

szDialogName

指定一个自定义对话框的名称，该对话框包含了其内容要被检索的多行编辑控件。

nControlID

指定多行编辑控件的资源 ID 。

listID

返回 nControlID 标识的编辑区中的行的一个字符串列表。由 listID 标识的字符串列表必须已经通过调用 ListCreate 而被初始化。

返回值：

0 ： CtrlGetMLEText 成功检索一个多行编辑区的内容。

< 0 ： CtrlGetMLEText 未能检索控件的内容。

6.6 CtrlGetMultCurSel

语法： CtrlGetMultCurSel (szDialogName, nControlID, listID);

说明： CtrlGetMultCurSel 函数检索一个多选列表框控件中的当前被选定的行。多选列表框的每个被选定行被放到由 listID 标识的一个字符串列表中。为从一个单选列表框控件中检索被选定的文本，调用 CtrlGetCurSel 。 CtrlGetMultCurSel 只使用于自定义对话框。

参数：

szDialogName

指定一个自定义对话框的名称，该对话框包含了其内容要被检索的列表框控件。

nControlID

指定多行编辑控件的资源 ID 。

listID

返回由 nControlID 标识的列表框中的行。由 listID 标识的字符串列表必须已经通过调用 ListCreat 而被初始化。

返回值：

0 ： CtrlGetMultCurSel 成功检索当前选定项目。

< 0 ： CtrlGetMultCurSel 未能检索项目。

6.7 CtrlGetState

语法： CtrlGetState (szDialogName, nControlID);

说明： CtrlGetState 函数得到一个自定义对话框中一个复选框或单选钮的当前状态。

参数：

szDialogName

指定包含该控件的对话框的名称。

nControlID

指定其状态要被检索的复选框或单选钮的资源 ID 。

返回值：

BUTTON_CHECKED (-1001) ：复选框或单选钮被选定。

BUTTON_UNCHECKED (-1002) ：复选框或单选钮未被选定。

DLG_ERR (-1) ： CtrlGetState 不能确定控件状态。

6.8 CtrlGetSubCommand

语法： CtrlGetSubCommand (szDialogName);

说明： CtrlGetSubCommand 函数检索对一个自定义对话框中的一个控件所执行的操作。例如， CtrlGetSubCommand 可以告诉你用户单击或双击了一个列表框或组合框控件。它也可以告诉你一个编辑区的内容被修改了。

高级开发人员可以调用 CmdGetHwndDlg 来处理附加信息。

参数：

szDialogName

指定自定义对话框的名称。

返回值：

EDITBOX_CHANGE (-1007) ：编辑框的内容已经改变。

LISTBOX_ENTER (-1008) ：用户双击了一个列表框项目。

LISTBOX_SELECT (-1009) ：用户单击了一个列表框项目。

6.9 CtrlGetText

语法： CtrlGetText (szDialogName, nControlID, svText);

说明： CtrlGetText 函数从一个自定义对话框中的一个编辑区，静态文本区或按扭控件中检索文本。为从多行编辑区控件中检索文本，调用 CtrlGetMLEText 。

参数：

szDialogName

指定一个对话框的名称，该对话框包含了其文本要被检索的区域或控件。

nControlID

指定编辑区，静态文本区或下按按扭控件的资源 ID 。

svText

从由 nControlID 标识的控件或区域中返回的文本。

返回值：

0 ： CtrlGetText 成功检索控件的内容。

< 0 ： CtrlGetText 未能检索内容。

6.10 CtrlPGroups

语法： CtrlPGroups (szDialogName, nControlID);

说明： CtrlPGroups 函数将一个现存程序文件夹列表放到一个列表框或组合框控件中。该函数仅工作于自定义对话框。

参数：

szDialogName

Specifies the name of a custom dialog box that contains the control to use.

指定自定义对话框的名称，该对话框包含要使用的控件。

nControlID

指定一个列表框或组合框控件的资源 ID 。

返回值：

0 ： CtrlPGroups 成功把指定的程序文件夹列表放到控件中。

< 0 ： CtrlPGroups 未能把指定的程序文件夹列表放到控件中。

6.11 CtrlSelectText

语法： CtrlSelectText (szDialogName, nControlID);

说明： CtrlSelectText 函数选定一个编辑区或一个组合框的编辑区中的所有文本。如果该控件是一个多行编辑区，该函数选定所有行的所有文本。该函数仅工作于自定义对话框。

参数：

szDialogName

指定一个有效对话框的名称，该对话框包含要被选定的编辑区。

nControlID

指定要被选定的编辑区或组合框控件的资源 ID 。

返回值：

0 ： CtrlSelectText 成功选定了区域中的所有文本。

< 0 ： CtrlSelectText 未能选定文本。

6.12 CtrlSetCurSel

语法： CtrlSetCurSel (szDialogName, nControlID, szText);

说明： CtrlSetCurSel 函数在指定的列表框或组合框控件中查找一个字符串。如果找到， CtrlSetCurSel 选定（高亮显示）该项目。对多选列表框和组合框则调用 CtrlSetMultCurSel 。 CtrlSetCurSel 函数仅使用于自定义对话框。

参数：

szDialogName

指定一个有效自定义对话框的名称，该对话框包含要被查找的控件。

nControlID

指定包含查找字符串的控件的资源 ID 。

szText

指定查找字符串。如果该字符串被找到，则被选定（高亮显示）。

返回值：

0 ： CtrlSetCurSel 成功找到和选定了指定的字符串。

< 0 ： CtrlSetCurSel 未能找到和选定指定的字符串。

6.13 CtrlSetFont

语法： CtrlSetFont (szDialogName, hFont, nControlID);

说明： CtrlSetFont 函数指定一个自定义对话框中一个控件的字体。在对话框消息处理循环中的 DLG_INIT 例程中调用该函数。

参数：

szDialogName

指定一个有效对话框的名称。

hFont

指定已经通过调用 GetFont 而被创建的一个字体的处理程序。

nControlID

指定其字体要被设置的控件的资源 ID 。为给对话框中的所有控件设置字体，给该参数传递预定义常量 ALLCONTROLS 。

返回值：

0 ： CtrlSetFont 成功在一个对话框中设置所要求的字体。

< 0 ： CtrlSetFont 未能在一个对话框中设置所要求的字体。

6.14 CtrlSetList

语法： CtrlSetList (szDialogName, nControlID, listID);

说明： CtrlSetList 函数把一个字符串列表中的内容放到指定的单或多选列表框或组合框控件中。任何原先存在的内容被包含在 listID 中的项所置换。 InstallShield 将字符串列表中的每个元素放到列表框或组合框控件中的每个元素中。

参数：

szDialogName

指定包含列表框或组合框的对话框的名称。

nControlID

指定列表框或组合框的资源 ID 。

listID

指定一个字符串列表的名称，该列表包含要被拷贝到列表框或组合框控件中的元素。

返回值：

0 ： CtrlSetList 成功将字符串的内容放到控件中。

< 0 ： CtrlSetList 未能将字符串的内容放到控件中。

6.15 CtrlSetMLEText

语法： CtrlSetMLEText (szDialogName, nControlID, listID);

说明： CtrlSetMLEText 函数设置一个多行编辑框控件中的文本。 InstallShield 将 listID 中的每个字符串分别放进该多行编辑框控件中。该函数仅使用于自定义对话框。

参数：

szDialogName

指定一个对话框的名称。

nControlID

指定一个对话框中的多行编辑框控件的资源 ID 。

listID

指定一个有效字符串列表的名称，该列表包含了要被拷贝到多行编辑控件中的元素。

返回值：

0 ： CtrlSetMLEText 将文本设置到控件中。

< 0 ： CtrlSetMLEText 未能设置控件中的文本。

6.16 CtrlSetMultCurSel

语法： CtrlSetMultCurSel (szDialogName, nControlID, szText, nSelectFlag);

说明： CtrlSetMultCurSel 函数查找指定的多选列表框或组合框控件。如果 nSelectFlag 被设置为 TRUE ， CtrlSetMultCurSel 选定（高亮显示）被找到的项目。该函数仅使用于自定义对话框。

参数：

szDialogName

指定一个自定义对话框的名称。

nControlID

指定对话框中多选列表框或组合框控件的资源 ID 。

szText

指定查找字符串。

nSelectFlag

指示当 CtrlSetMultCurSel 找到一个项目时是否要高亮显示它。在该参数位置传递下列预定义常量之一：

TRUE ：表明该项目要被高亮显示。

FALSE ：表明该项目不被高亮显示。

返回值：

0 ： CtrlSetMultCurSel 在控件中找到文本，并根据 nSelectFlag 所指示的高亮显示它或不高亮显示它。

< 0 ： CtrlSetMultCurSel 未能在控件中找到文本。

6.17 CtrlSetState

语法： CtrlSetState (szDialogName, nControlID, nState);

说明： CtrlSetState 函数设置一个自定义对话框中的一个复选框或单选钮的当前状态。当你用一个资源编辑器或对话框编辑器创建单选钮和复选框时，你可以设置它们的某些特性。如果你因一个按扭的性能遇到了困难，则在编辑器中检查该控件的特性。

参数：

szDialogName

指定一个对话框的名称，该对话框包含复选框或单选钮控件。

nControlID

指定复选框或单选钮控件的资源 ID 。

nState

指定按扭控件的新状态。在该参数位置传递下列预定义常量之一：

BUTTON_CHECKED ：设置按扭状态为 CHECKED 。

BUTTON_UNCHECKED ：设置按扭状态为 UNCHECKED 。

返回值：

0 ： CtrlSetState 成功设置复选框或单选钮控件的状态。

< 0 ： CtrlSetState 未能设置该控件的状态。

6.18 CtrlSetText

语法： CtrlSetText (szDialogName, nControlID, szText);

说明： CtrlSetText 函数设置一个自定义对话框中一个单行编辑区，静态文本区或按扭控件的文本。为设置多行编辑区中的文本，调用 CtrlSetMLEText 。

参数：

szDialogName

指定一个对话框的名称。

nControlID

指定其中的文本要被设置的单行编辑区，静态文本区或按扭控件的资源 ID 。

szText

指定放到控件中的文本。

返回值：

0 ： CtrlSetText 成功设置控件中的文本。

< 0 ： CtrlSetText 未能设置控件中的文本。

6.19 DefineDialog

语法： DefineDialog (szDialogName, hInstance, szDLLName, nDialogID, szDialogID,

nReserved, hwndOwner, lMsgLevel);

说明： DefineDialog 函数定义一个自定义对话框。当你需要指定一个其属性不能由 EzDefineDialog 指定的对话框的属性时，调用该函数而不是 EzDefineDialog 。注意 DefineDialog 不显示自定义对话框。为显示一个自定义对话框，你必须调用 WaitOnDialog 。

参数：

szDialogName

指定你要定义的自定义对话框的名称。该名称标识该对话框并使用在所有随后对自定义对话框函数的调用中。该对话框的名称是区分大小写的，你必须完全按照你在该参数指定的那样来使用它。

hInstance

指定对话框驻留其中的 DLL 的实例句柄。如果你在 szDLLName 指定 DLL 的全限定名，你可以将该参数指定为 0 。为得到一个 DLL 的实例句柄，调用 Microsoft Windows API LoadLibrary 。

szDLLName

指定包含对话框资源的 DLL 文件的全限定名。如果你不指定一个路径， InstallShield 在 Windows 文件夹中查找该 DLL 。如果在那儿没有找到， InstallShield 查找在查找路径中指定的文件夹。如果你用参数 hInstance 指定 DLL 的实例句柄，你可以给该参数传递一个空字符串。当对话框位于 _isuser.dll 时，你可以为该参数指定一个空字符串。如果该参数指定为一个空字符串， InstallShield 将自动检测 _isuser.dll 。

nDialogID

如果你使用一个数字（而不是一个字符串）来标识对话框资源时，该参数指定资源 ID 。该参数只在 szDialogID 是一个空字符串时被使用。建议使用该参数而不是 szDialogID 来标识对话框资源。

szDialogID

如果你使用一个字符串（而不是一个数字）来标识对话框资源时，该参数指定资源 ID 。如果该参数是一个空字符串， nDialogID 被用来标识对话框资源。强烈提议使用 nDialogID 而不是 szDialogID 来标识对话框资源。

nReserved

给该参数传递 0 。不允许其它值。

hwndOwner

指定主窗口的窗口句柄。将该参数指定为 HWND_INSTALL 来使得 InstallShield 主安装窗口成为对话框的主窗口。

lMsgLevel

该参数指定哪些窗口消息要被发送到该对话框。你必须用或操作符来将下列常量之一和常量 DLG_CENTERED 组合：

DLG_MSG_STANDARD ：筛选掉大多数 Windows 消息；只有那些直接和对话框控件关联的被传递到对话框。

DLG_MSG_ALL ：传递大多数 Windows 消息。

返回值：

0 ： DefineDialog 成功定义对话框。

DLG_ERR_ALREADY_EXISTS (-3) ：你正试图定义一个已经由 DefineDialog 定义的对话框。你不能用相同的名称定义两个对话框。

DLG_ERR (-1) ：表示发生一个未确定的错误。

6.20 EndDialog

语法： EndDialog (szDialogName);

说明： EndDialog 函数关闭一个自定义对话框。它删除对话框并启动对话框关闭进程。当下列任意一种情况存在时，使用 EndDialog ：

Next 按扭或其等效已经被处理。
Cancel 按扭或其等效已经被处理。
Close 系统菜单选项已经被选定（该行为发送 DLG_CLOSE 消息）。
用户结束对话框操作的任何其它情况。

参数：

szDialogName

指定要关闭的对话框的名称。

返回值：

0 ： EndDialog 成功关闭对话框。

< 0 ： EndDialog 未能关闭对话框。

注解：

·在调用 EndDialog 关闭一个自定义对话框后，调用 ReleaseDialog 函数来释放与该自定义对话框关联的内存。

·只要你还没有调用 ReleaseDialog 来把对话框从内存删除，你可以就通过调用 WaitOnDialog 来重新显示一个已经由调用 EndDialog 关闭的自定义对话框。然而要注意，如果你调用 WaitOnDialog 来打开一个在你脚本中已经被打开和关闭的对话框时，你必须再次调用 CmdGetHwndDlg 来得到新句柄。老的句柄不再有效。

6.21 EzDefineDialog

语法： EzDefineDialog (szDialogName, szDLLName, szDialogID, nDialogID);

说明： EzDefineDialog 函数定义一个自定义对话框。注意 EzDefineDialog 不显示自定义对话框。为显示一个自定义对话框，你必须调用 WaitOnDialog 。

参数：

szDialogName

指定和由 szDialogID 或 nDialogID 指定的对话框相关联的名称。为处理该对话框，在随后的对自定义对话框函数的调用中使用该名称。注意该对话框的名称是区分大小写的，你必须完全按照你在该参数指定的那样来使用它。

szDLLName

szDialogID

nDialogID

返回值：

0 ： EzDefineDialog 成功定义对话框。

DLG_ERR_ALREADY_EXISTS (-3) ：你正试图定义一个已经由 EzDefineDialog 定义的对话框。你不能用相同的名称定义两个对话框。

DLG_ERR (-1) ：表示发生一个未确定的错误。

6.22 GetFont

语法： GetFont (szFontName, nPointSize, nAttributes);

说明： GetFont 函数建立一个字体并检索它的句柄，你可以使用字体句柄来指定在一个自定义对话框中的控件使用的字体。

参数：

szFontName

指定你要建立的字体的名称。

nPointSize

指定你要建立的字体的点数。

nAttributes

指定字体风格。在该参数位置传递下列预定义常量之一。可以用按位或操作符 (|) 组合常量来指定多种风格：

STYLE_BOLD ：指定一个粗体风格的字体。

STYLE_ITALIC ：指定斜体风格。

STYLE_NORMAL ：指定一个正常的系统字体。

STYLE_UNDERLINE ：指定字符被加下划线。

返回值：

XXXX ： XXXX 是该字体的句柄。

0 ： GetFont 未能建立所要求的字体。

注解：

·当安装中止时， InstallShield 将删除所有由该函数创建的字体。另外，中止时， InstallShield 释放所有系统资源。

6.23 HIWORD

语法： HIWORD (lValue);

说明： HIWORD 函数从由 lValue 指定的 32 位整型值中析取和返回高位字（高 16 位）。

参数：

lValue

指定要从中析取高 16 位的 32 位整数。

返回值：

HIWORD 返回 lValue 的高位字（高 16 位）。

注解：

· InstallShield 的 HIWORD 因使用符号扩展而和相应的 C 的宏不同。因此，如果 lValue 是一个负数，则由 HIWORD 返回的值的高位字节用 1 填充。如有必要，你可以将结果和 0xFFFF 按位与 (AND) 来生成一个正数，如下所示：

lValue = HIWORD(lValue);

lValue = lValue & 0xFFFF;

6.24 LOWORD

语法： LOWORD (lValue);

说明： LOWORD 函数从由 lValue 指定的 32 位整型值中析取和返回低位字（低 16 位）。

参数：

lValue

指定要从中析取低 16 位的 32 位整数。

返回值：

该函数返回整数的低位字（低 16 位）。

6.25 ReleaseDialog

语法： ReleaseDialog (szDialogName);

说明： ReleaseDialog 函数释放与 szDialogName 标识的自定义对话框相关联的所有内存。调用 EndDialog 后调用该函数。在消息处理的 case 语句外面调用该函数。

参数：

szDialogName

指定要消除的对话框的名称。

返回值：

0 ：表明函数成功释放和对话框相关联的所有内存。

DLG_ERR (-1) ：函数失败。对话框名可能是无效的。

DLG_ERR_ENDDLG (-2) ：在调用 EndDialog 前调用了 ReleaseDialog 。你必须首先调用 EndDialog 来删除对话框。

6.26 SdMakeName

语法： SdMakeName (svSection, szDlg, szUnused, nvDlgName);

说明： SdMakeName 函数为一个对话框创建一个节名。该节名在向一个 .iss 文件写或从一个 .iss 文件中读时使用， .iss 文件由 InstallShield Silent 使用。

参数：

svSection

指定节名。 InstallShield 使用变量 szDlg 和 nvDlgName 来给该变量置一个值。该值由 SilentReadData 和 SilentWriteData 使用。

szDlg

指定对话框的名称，用来创建一个节名。

szUnused

该参数未用；给该参数传递一个空字符串。

nvDlgName

指定计数器，它记录针对 szDlg 指定的对话框而调用 SdMakeName 的次数。 InstallShield 自动递增该计数器。为每个自定义对话框使用一个唯一的变量名。（看下面的注解）

返回值：

无。

注解：

·为正确命名节，你必须为每个不同的自定义对话框在第四个参数使用一个唯一的变量名。要做到这一点的简单的方法是：使用 szDlg 的对话框名来命名变量。例如，当 szDlg 是 "MyDlgOne" 时，命名第四个参数的变量为 nvMyDlgOne ；当 szDlg 是 "MyDlgTwo" 时，命名变量为 nvMyDlgTwo 。

6.27 SilentReadData

语法： SilentReadData (szSection, szValName, nValType, svVal, nvVal);

说明：当一个安装运行于静止方式 (silent mode) 时（带 -s 开关运行 Setup.exe 时）， SilentReadData 函数指示 InstallShield Silent 如何为一个自定义对话框读取 .iss 文件对话框数据。注意你可以通过调用 SilentWriteData 来创建一个 .iss 文件。

为在你的脚本中使用 SilentReadData ，构造逻辑结构因而它首先检测来确认安装运行于静止方式。把 SilentReadData 函数的调用放置在一个测试系统变量 MODE 的 if-else 语句中，如下所示：

if (MODE=SILENTMODE) then

// 在此调用 SilentReadData 。

else

// 在此调用一个正常的， non-silent 函数。

endif;

自定义对话框可以是在你的安装脚本中使用函数（如 EzDefineDialog 和 WaitOnDialog ）调用和处理的资源，也可以完全是外部的，如调用 DLL 中的函数一样被执行。另外一种情况是，你必须使用 SilentReadData 从 .iss 文件中检索对话框按扭的返回值（ Next 、 Back 、 Cancel 等等。）和在变量中被设置或返回的值。

参数：

szSection

指定 .iss 文件中的对话框数据的节的名称。不要包括方括号 ([ ]) 。参数 szSection 的格式为 <functionname>-<number> ， <functionname> 是在脚本中使用的对话框函数名， <number> 是在脚本中对话框出现的次数，从 0 开始。例如， MyDialog 函数对话框的第一次出现会有一个 szSection 值 "MyDialog-0" ，第二次出现则为 "MyDialog-1" ，第三次为 "MyDialog-2" ，如此继续。

szValName

指定出现在 .iss 文件的对话框数据的节中的值名。每个对话框至少有一个给 szValName 的值，来标识对话框按扭控件 (BACK, NEXT 或 OK, 或 CANCEL) 返回的值。其它值名用来标识和其它对话框控件相关联的值和数据。

nValType

标识赋给 szValName 中的值名的值的数据类型。值本身被保存在 svVal 或 nvVal 中，视 nValType 的值而定。在该参数位置传递下列预定义常量之一：

DATA_STRING ：赋给 szValName 中的值名的值是 STRING 类型。它的值将保存在 svValue 中。

DATA_NUMBER ：赋给 szValName 中的值名的值是 NUMBER 类型。它的值将保存在 nvValue 中。

DATA_COMPONENT ：赋给 szValName 中的值名的值是一个组件名。它的值将保存在 svValue 中。

DATA_LIST ：赋给 szValName 中的值名的值是一个 InstallShield 列表的列表 ID 。它的值将保存在 nvValue 中。

svVal

指定当 nValType 是 DATA_STRING 或 DATA_COMPONENT 时，赋给 szValName 中的值名的值。

nvVal

指定当 nValType 是 DATA_NUMBER 或 DATA_LIST 时，给 szValName 中的值名的值。

返回值：

0 ： SilentReadData 成功指示 InstallShield Silent 如何为自定义对话框读取对话框数据。

< 0 ： SilentReadData 未能指示 InstallShield Silent 如何为自定义对话框读取对话框数据。

注解：

下列情况下 SilentReadData 将失败（返回值小于 0 ）：

.iss 文件未找到。
脚本中的对话框次序没有和 .iss 文件中指定的对话框次序完全匹配。
指定的对话框数据节在 .iss 文件中没有被找到。
指定的关键字名没有在指定的对话框数据节中找到。
赋给指定的关键字名的值的数据类型和在 SilentReadData 调用中指定的不匹配。

6.28 SilentWriteData

语法： SilentWriteData (szSection, szValName, nValType, szVal, nVal);

说明： SilentWriteData 函数记录安装过程中自定义对话框中所作的选择。该选择数据被写到一个 .iss 文件中，供 InstallShield Silent 使用。为在一个安装过程中写写一个 .iss 文件，带 -r 开关项运行 Setup.exe 。

自定义对话框可以是在你的安装脚本中使用函数（如 EzDefineDialog 和 WaitOnDialog ）调用和处理的资源，也可以完全是外部的，如调用 DLL 中的函数一样被执行。另外一种情况是，你必须使用 SilentReadData 从 .iss 文件中检索对话框按扭的返回值（ Next, Back, Cancel, 等等。）和在变量中被设置或返回的值。

参数：

与 SilentReadData 函数的参数相同。

返回值：

0 ： SilentReadData 成功写自定义对话框的对话框数据到 Setup.iss 中。

< 0 ： SilentReadData 未能写自定义对话框的对话框数据到 Setup.iss 中。

6.29 WaitOnDialog

语法： WaitOnDialog (szDlgName);

说明： WaitOnDialog 函数显示一个自定义对话框。你的脚本可以根据该函数的返回值来处理用户的不同响应。

参数：

szDlgName

指定要显示的对话框的 ID 。

返回值：

dialog 控件 ID ：接收到 WM_COMMAND 消息的对话框控件的 ID 。

DLG_CLOSE (-200) ：该消息作为对话框将要被关闭的信号。

DLG_ERR (-1) ：如果发生任何错误，则接收到该消息。

DLG_INIT (-100) ：就在对话框要被显示前接收到该消息。

7 组件函数

下列函数允许你控制文件媒体、创建和处理脚本创建的组件组：

ComponentAddItem

增加一个新的组件到脚本创建的组件组中。

ComponentCompareSizeRequired

确定是否有足够的空闲磁盘空间给选定的组件。

ComponentDialog

呈现一个对话框，允许最终用户选择组件和指定一个目标位置。

ComponentError

当一个组件函数失败时，返回附加的错误信息。

ComponentFilterLanguage

激活和禁用基于语言的筛选（程序）。

ComponentFilterOS

激活或禁用基于操作系统的筛选。

ComponentGetData

检索一个组件的有关信息。

ComponentGetItemSize

确定一个指定组件的大小。

ComponentGetTotalCost

确定已经被指定的组件安装和卸载所需的总的空间。

ComponentInitialize

准备供存取的文件媒体库。

ComponentIsItemSelected

确定指定的组件是否已由最终用户选定。

ComponentListItems

创建一个文件媒体库中或一个脚本创建的组件组中的组件列表。

ComponentMoveData

传输和解压缩与文件媒体库中被选组件相关联的文件。

ComponentReinstall

配置安装，使得下一个对 ComponentTransferData 的调用执行上一次安装运行时指定的文件传输。

ComponentRemoveAll

配置安装，使下一个对 ComponentTransferData 的调用卸载掉安装。

ComponentSelectItem

选定或撤消选定组件。

ComponentSetData

为指定的组件设置属性和数据。

ComponentSetTarget

指定一个用户定义的变量，放置在一个组件的 <TARGETDIR> 域。

ComponentTransferData

执行已经被指定的组件安装和卸载。

ComponentSetupTypeEnum

列举与指定的文件媒体库相关联的安装类型。

ComponentSetupTypeGetData

检索和一个指定的已经在 InstallShield IDE 中创建的安装类型相关联的数据。

ComponentSetupTypeSet

选择与指定的安装类型相关联的所有组件。

ComponentTotalSize

以字节为单位计算选定的组件和子部件的总的大小。

ComponentValidate

确认整个文件媒体库的或在文件库媒体中的一个指定组件的口令。

SdSetupType

显示一个对话框，使最终用户选择三个标准安装类型：典型、简明或自定义中的一个。

SdSetupTypeEx

显示一个对话框，使最终用户选择标准和自定义的安装类型。

7.1 ComponentAddItem

语法： ComponentAddItem (szComponentSet, szComponent, nDataSize, bSelected);

说明： ComponentAddItem 函数增加一个组件到一个脚本创建的组件组中。如果一个由 szComponentSet 指定的脚本创建组件组不存在，它将被创建。每次要增加一个组件到给定的脚本创建组件组中，都要调用 ComponentAddItem 。你可以创建多个脚本创建组件组，每个都有一个唯一的名称（参数 szComponentSet ）。

为显示一个供选择的单级组件，使用 ComponentDialog, SdComponentDialog, 或 SdComponentDialogAdv 。使用 SdComponentDialog2 或 r SdComponentMult 来显示组件和它们的子部件。

该函数不能使用到文件媒体库。

参数：

szComponentSet

指定要增加一项的脚本创建的组件组的名称。如果脚本创建组件组不存在， ComponentAddItem 将创建它。

szComponent

指定要增加的组件名称。不要使用一个空字符串 ("") 。

下面是有关指定在函数调用中的组件和子部件的信息：

（指在函数调用中的组件和子部件）

组件是一个涉及一组文件组和 / 或子部件的通用术语。一个子部件也只是一个组件。它位于其它组件下面，这与和文件夹和子文件夹的关系相似。
"顶层组件"是在分层结构中的最高层组件。顶层组件从不作为子部件被引用。
一些 InstallShield 组件函数要求你指向一单个组件，而其它的要求你指向多个组件。

为指向一单个组件，使用该组件的名称。为指向一个子部件，使用一个路径形式的表达式，其中分层结构中引向该组件的每个组件的名称由双反斜杠分隔。例如，为指定顶层组件帮助文件下的子部件教学，在你的脚本中使用下列表达式。

szComponent = "Help Files\\Tutorials";

为引用教学下的子部件 CBT ，使用下列表达式：

szComponent = "Help Files\\Tutorials\\CBT";

一些组件和安装类型对话框函数，如 SdComponentMult ，显示多个组件和它们的子部件。这些情况下，你可指向多个组件，只要指定在分层结构中就在它们上层的组件即可。如果组件是顶层组件，使用一个空字符串 ("") 来引用它们。

例如，如果你传递一个空字符串给 SdComponentMult 函数，在组件窗口中将显示你的文件媒体库中的所有顶层组件或你的脚本创建的组件组中的所有顶层组件，依赖于系统变量 MEDIA 的值。所有子部件将显示在 Subcomponents 窗口中。

另一方面，如果你传递一单个顶层组件（如上例中的帮助文件）给 SdComponentMult 函数，它将在 Components 窗口中显示它的子部件（如上例，在教学层）和在 Subcomponents 窗口中显示它的下一个更低层的子部件（如上例，在 CBT 层）。

nDataSize

以字节数指定组件代表的数据的大小。如果组件是一个文件序列，该参数指定所有文件的总的非压缩大小。

bSelected

指定组件的缺省选择设置。在该参数位置传递下列预定义的常量之一：

TRUE ：表明该组件缺省为选定。如果 TRUE 传递给一个子部件，而它的父亲组件是撤消选定的，则尽管给参数 bSelect 传递了 TRUE ，该子部件也将被撤消选定。

FALSE ：表明组件缺省为撤消选定。

当用户选择显示在对话框中的一个组件或子部件时，缺省选择设置被清除。如果用户撤消选定一个组件，所有它的子部件将被撤消选定。如果用户撤消选定一个组件的所有子部件，该组件将被撤消选定。

返回值：

0 ： ComponentAddItem 成功将数据项加入到组件或子部件。

< 0 ： ComponentAddItem 未能将数据项加入到组件或子部件。调用 ComponentError 看附加信息。

注解：

·组件名必须不包含这些字符，它们是在资源管理器处理程序下的非法文件名字符；包括下列字符： / \ ·? " < > | 。试图创建一个包含一个或多个这些字符的组件名将导致 ComponentAddItem 失败。

·你可以使用 ComponentAddItem 和脚本创建的组件组来允许用户从文件媒体组件选项之外的选项中选择。

·由调用 ComponentAddItem 开始，创建一个脚本创建的包含你需要的选项的组件组。

然后通过调用 SdAskOptions 或 SdAskOptionsList 来显示那些供选择的选项，它们的参数 szComponent 传递脚本创建的组件组的名称。最后，通过调用 ComponentIsItemSelected 确定被选定的选项。

7.2 ComponentCompareSizeRequired

语法： ComponentCompareSizeRequired (szMediaLibrary, svTarget, nvSize);

说明： ComponentCompareSizeRequired 函数确定目标文件夹是否能提供给选定组件足够空闲空间，这些组件由 szMediaLibrary （必须是一个文件媒体库）指定。如果目标文件夹没有足够空闲空间，由参数 svTarget 返回全限定文件夹名，并且由参数 nvSize 返回所需空闲空间大小。

注意参数 svTarget 仅被用来返回一个文件夹名。你不能使用该参数来指定一个目标文件夹。 ComponentCompareSizeRequired 检查目标文件夹指示的驱动器，目标文件夹是你为每个组件在属性表上指定的。如果 szMediaLibrary 是一个文件媒体库，它有要被安装在通用应用目的文件夹上的组件，你必须在调用 ComponentCompareSizeRequired 前将目标路径赋给 TARGETDIR 。你可以通过调用 AskDestPath 或一个组件对话框从一个最终用户那儿得到一个目标路径。

如果你的安装程序将在运行时为一个文件库中的一个组件指定一个目标文件夹，它必须在用 ComponentCompareSizeRequired 检查空闲空间前，通过调用 ComponentSetTarget 来做到这一点。

该函数不能使用到脚本创建的组件组。

参数：

szMediaLibrary

指定文件媒体库的媒体名，该库所包含的组件的总的大小将和目标驱动器上的空闲空间进行比较。如果该参数包含一个脚本创建的组件组的名称，该函数将失败。

svTarget

如果在目标驱动器上有足够的有效空闲空间，返回一个空字符串 ("") 。如果在目标驱动器上没有足够空闲空间，返回目标路径。

nvSize

如果在目标驱动器上有足够有效空闲空间，返回 0 。如果在目标驱动器上没有足够空闲空间，返回所需的大小（字节数）。

返回值：

0 ： ComponentCompareSizeRequired 成功。

< 0 ： ComponentCompareSizeRequired 失败。调用 ComponentError 看附加信息。

7.3 ComponentDialog

请参阅 4.6

7.4 ComponentError

语法： ComponentError (svComponentSource, svComponent, svFileGroup, svFile, nvError);

说明：当一个组件函数返回值小于０时 ComponentError 函数得到辅助错误信息。下列代码段显示一个典型的 ComponentError 的实现：

nResult = ComponentTransferData(MEDIA);

if(nResult < 0) then

ComponentError(svComponentSource, svComponent, svFileGroup, svFile, nvError);

SprintfBox(INFORMATION, "ComponentTransferData Error Information",

"ComponentTransferData had the following error:\n\n" +

"Media Name: %s\nComponent: %s\nFile Group: %s\n" +

"File: %s\nError Number: %ld"

svComponentSource, svComponent, svFileGroup, svFile, nvError);

endif;

ComponentError 函数必须只有在另一个组件函数返回值小于０时才被调用。如果当另一个组件函数没有返回小于０的值时调用 ComponentError 函数，则可能返回无效的错误代码。

调用下列函数时 ComponentError 不返回有关发生的错误的辅助信息：

ComponentSetupTypeEnum
ComponentSetupTypeSet

参数：

svComponentSource

返回与由 nvError 指定的错误相关的文件媒体库或脚本创建的组件组的媒体名。

svComponent

返回与由 nvError 指定的错误相关的组件名。

svFileGroup

返回与由 nvError 指定的错误相关的文件组名。

svFile

返回与由 nvError 指定的错误相关的文件名。

nvError

返回一个代码，它标识先前调用一个组件相关函数时发生的错误类型。这些错误的代码描述如下：

下表描述了由 ComponentError 返回的错误代码。注意在纠正了涉及媒体的错误后，你必须重建工程。

代码	描　　　述	原　　　因
-101	不能添加组件。	ComponentAddItem 不能添加一个组件到脚本创建的组件组中。
-102	指定的组件已经存在。	ComponentAddItem 被用相同的媒体名和组件名调用了两次。
-104	指定的组件名不是有效的。	传递给 ComponentInitialize 第二个参数的值不是有效的。
-105	指定的组件不能在媒体上找到。	试图访问一个不存在于指定媒体上的组件。当调用一个组件函数，而没有正确指定一个组件名时发生该错误。被指定的组件名必须和显示在组件窗格中或在对 ComponentAddItem 的调用中的完全相同。区分大小写。
-106	不能解压缩一个文件。	发生一个内部错误。技术支持请联系： http://support.installshield.com/contact/req_sup.asp .
-107	在 ComponentMoveData 调用中，指定了一个无效的磁盘 ID 。	ComponentMoveData 已经被调用来传输文件而还没有被重新初始化。为重新初始化 ComponentMoveData ，以第一个参数为一个空字符串来调用该函数。
-108	磁盘空间溢出。	目标磁盘或目录没有足够的空闲空间；因为 TARGETDIR 无效，磁盘空间不能被确定；或一个组件的脚本创建的文件夹还没有被设置。
-109	EnterDisk 函数调用失败。	发生内部错误。
-112	不能找到指定的文件。	为确定丢失了哪个文件，检查 ComponentError 返回的参数 svFile 的值。
-113	指定的文件为只读，不能被打开。	Data1.cab 文件（或其它数据 cab 文件之一）丢失或破坏；或一个ＣＤ－ＲＯＭ上的解压缩数据文件丢失。
-114	指定的文件不能以读／写打开。	不能增补到分类文件。技术支持请联系： http://support.installshield.com/contact/req_sup.asp.
-115	指定的文件不能以写打开。	试图改写一个文件组中的一个锁定文件，该文件组没有锁定位（ potentially locked ）或共享属性设置为 Yes 或到目标文件夹的路径是无效的。
-117	不能读指定文件。	一个数据 cab 文件 (.cab) 或一个解压缩数据文件可能已毁坏。
-118	不允许试图操作脚本创建的组件组。	一个脚本创建的组件组名被传递给一个只在文件媒体上执行的组件函数。
-119	不能正确自注册一个文件。	该错误有许多可能的原因。详细情况可参阅 InstallShield Knowledge Base 中的 Q101538 文档。
-120	不能对 ComponentMoveData 中的共享文件进行更新。	内部错误。
-121	不能写文件。	内部错误。
-123	不能找到一个文件组。	不能找到指定的文件组。丢失的文件组名由 ComponentError 返回在参数 svFileGroup 。
-125	组件函数中指定的列表无效。	当调用 ComponentListItems ， ComponentSetupTypeEnum 时，确认你传递给函数的列表是有效的。
-126	不允许试图操作文件媒体库。	一个文件媒体名传递给一个只在脚本创建的组件集上执行的组件函数（如， ComponentAddItem ）。
-127	媒体已经初始化。	ComponentInitialize 被调用来初始化一个已经被初始化了的媒体。
-128	指定的文件媒体库没有由 InstallShield 媒体向导生成。	Data1.cab 文件被破坏，或调用 ComponentInitialize 中指定的文件不是一个 InstallShield 生成的 cab 文件。
-132	指定的媒体没有被找到。	媒体已经被声明但还没有和任何组件相关联。确保脚本创建的组件或文件媒体组件和该媒体相关联。
-133	指定媒体发生一个错误。	ComponentMoveData 已经被调用来传输文件但还没有被重新初始化。如果你的脚本调用 ComponentMoveData 超过一次，你必须每次调用后重新初始化它，可通过让它的第一个参数为一个空字符串来再次调用它而实现重新初始化。
-136	不能分配内存。	安装没有足够的有效内存。显示一个消息给最终用户，关闭所有其它的应用程序或取消安装，重启系统和重新开始安装。
-137	指定的选项是无效的。	给一个组件函数指定了一个无效的选项，例如，当一个文件组和文件名都需要时，只指定了一个文件组。
-139	指定的口令不符。	指定的口令与保存在指定的文件媒体库或组件中的口令不符。
-141	指定的口令不能被找到。	ComponentValidate 被调用来验证一个没有被设置口令的组件或文件媒体库。
-142	媒体或组件的口令没有被确认。	在用 ComponentMoveData 传输那些组件前没有调用 ComponentValidate 来验证组件和／或文件媒体库。
-145	组件的目标路径没有找到。	一个脚本定义的文件的目标目录没有被设置或是无效的。增加或改正对 ComponentSetTarget 的调用；然后重建。
-147	传递无效值给一个组件有关函数。	传递给一个组件有关函数的一个值无效。例如，传递一个空字符串给 ComponentAddItem 函数的第二个参数可以引起该错误。
-148	数据不能从互联网读得。	当使用 InstallFromTheWeb 与 InstallShield5 连接时发生该错误。由于文件被破坏或 Internet 连接丢失并且不能通过 InstallFromTheWeb 重新建立连接， InstallShield 不能从 Internet 读取数据
-149	Internet 已经被断开。	当使用 InstallFromTheWeb 与 InstallShield5 连接时发生该错误。 Internet 连接已经丢失并且不能通过 InstallFromTheWeb 重新建立连接。
-150	cab 文件 (.cab) 由 InstallShield5 的旧版本生成。	确保工程是由你的 InstallShield5 最新版本建立的。确保你不在使用由 InstallShield5 的不同版本生成的不匹配的 cab 文件 (.cab) 。
-620	第三方 (third-party) 外壳程序错误	咨询有问题的外、外壳程序的有关文档来确定它是否是 100% 兼容的开发人员外壳程序。
-623	重命名文件错误。	没有将 Potentially Locked 属性设置为 Yes 时，试图传递一个可执行文件（一个 .exe 或 .cm 文件）。

返回值：

0 ： ComponentError 成功。

< 0 ： ComponentError 失败。

7.5 ComponentFilterLanguage

语法： ComponentFilterLanguage(szMediaLibrary, nLangID, bFiltered);

说明： ComponentFilterLanguage 函数从基于语言的文件传输中筛选（排除）文件。缺省时，包含在媒体库中的所有语言都是不筛选的（包含的）。给参数 nLangID 使用的语言 ID 选项不能用按位或操作（ | ）联接。你必须为你所希望筛选或不筛选的每个语言都调用 ComponentFilterLanguage 。

当安装程序第一次运行时所做的任何筛选在一个维护安装程序中也必须做。确定在初始安装和维护安装过程中被执行的代码中都调用该函数。不要从下列事件处理程序中调用该函数： OnAppSearch, OnCCPSearch, OnFirstUIBefore, OnFirstUIAfter, OnMaintUIBefore, or OnMaintUIAfter 。

在安装过程中，筛选语言具体文件组的最简单的方法如下所示：

通过调用 ComponentFilterLanguage （参数 nLangID 为 ISLANG_ALL ，参数 bFilter 设置为 TRUE 时）来筛选（排除）所有语言。

对每个你要安装的语言，都需在 nLangID 设置为合适的语言常量并且参数 bFiltered 设置为 FALSE 时调用 ComponentFilterLanguage 。每个调用将不筛选（包含） nLangID 指定的语言的文件组。

你不能通过或操作（ | ）在参数 nLangID 位置指定多个语言常量。指定多个语言常量将导致函数执行不正确。

当使用 ComponentFilterLanguage 时，记住在程序块前加入 #include "Sdlang.h" 。如果你使用由工程向导生成的 Setup.rul ，该行已经为你包括在里面了。

该函数不能工作于脚本创建的组件组。

参数：

szMediaLibrary

指定文件媒体库的媒体名。

nLangID

指定要筛选或不筛选的语言的 ID 。注意对每次函数调用仅能指定一个语言常量。为筛选所有语言，给该参数传递 ISLANG_ALL 。

bFiltered

指定是否筛选（排除）或不筛选（包含） nLangID 指定的语言。在该参数位置传递下列预定义常量之一：

TRUE ：筛选 nLangID 指定的语言；也就是，在文件传输中不包含它。

FALSE ：不筛选 nLangID 指定的语言；也就是，在文件传输中包含它。

返回值：

0 ： ComponentFilterLanguage 成功。

< 0 ： ComponentFilterLanguage 失败。

注解：

·当将该函数与 GetSystemInfo 函数一起使用时，你必须考虑下列情况：被用来指定语言特定文件组的语言常量只是可以由 GetSystemInfo 返回的语言常量的一个小的子集。

·如果你的安装包含基于这些返回值的语言筛选，你必须使用一个 switch 语句来转换由该函数返回的常量为支持语言筛选的常量之一。

·任何 InstallShield 版本将允许你指定任何语言的文件组或由 Windows 支持的子语言；然而，对一个由媒体向导建立的语言具体文件组，你使用的 InstallShield 版本必须支持该文件组的语言。你的安装必须也支持文件组的语言。

·如果你的安装包含语言具体文件组，它被具体指定到一个不被你正使用的 InstallShield 或你的安装支持的语言，文件组将被媒体向导筛选（不包含）。

7.6 ComponentFilterOS

语法： ComponentFilterOS (szMediaLibrary, nUpperOS, nLowerOS, bFiltered);

说明： ComponentFilterOS 函数筛选标志为指定操作系统的文件组。缺省时，不筛选操作系统。该函数不能使用到脚本创建的组件组。

安装初次运行时的任何筛选在一个维护安装时也必须做。确认在初始和维护安装中执行的代码中都调用了该函数。不要从下列事件处理程序中调用该函数： OnAppSearch, OnCCPSearch, OnFirstUIBefore, OnFirstUIAfter, OnMaintUIBefore, 或 OnMaintUIAfter 。

参数：

szMediaLibrary

指定文件媒体库的媒体名。

nUpperOS

指定一个 64 位操作系统标识符域的高 32 位。目前， nUpperOs 没有被使用。给该参数传递 0 。不允许其它值。

nLowerOS

指定一个 64 位操作系统标识符域的低 32 位。 nLowerOS 指定你希望筛选的操作系统。你可以使用按位或操作符 (|) 将值组合。

ISOSL_ALL 、 ISOSL_WIN95 、 ISOSL_WIN98 、 ISOSL_WIN2000

ISOSL_WIN2000_ALPHA 、 ISOSL_NT40 、 ISOSL_NT40_ALPHA 、 bFiltered

指定是否要筛选（排除）或不筛选（包括）在 n LowerOS 指定的操作系统。在该参数位置传递下列预定义常量之一：

TRUE ：筛选指定的操作系统；也就是，在文件传输中不包括它们。

FALSE ：不筛选指定的操作系统；也就是，在文件传输中包括它们。

返回值：

0 ： ComponentFilterOS 成功。

< 0 ： ComponentFilterOS 失败。调用 ComponentError 查看附加信息。

7.7 ComponentGetData

语法： ComponentGetData (szComponentSource, szComponent, nInfo, nvResult, svResult);

说明： ComponentGetData 函数检索一个组件的信息。当 szComponentSource 指向一个脚本创建组件组时，一些信息不能被检索。

参数：

szComponentSource

指定其信息要被检索的组件所在的文件媒体库或脚本创建组件组的媒体名。

szComponent

指定其信息要被检索的组件名。参阅。

nInfo

指定要检索的信息类型。在该参数位置传递下列预定义常量之一：

COMPONENT_FIELD_DESCRIPTION ：当组件在一个组件对话框中被选定时显示的说明。对于一个在文件媒体库中的组件，这是保存在组件属性窗口中说明域中的值。

COMPONENT_FIELD_FILENEED ：定义组件文件对于安装的关键性程度。下列值之一将被设置到 nvResult ：

COMPONENT_VALUE_CRITICAL ：该组件包含关键性文件。

COMPONENT_VALUE_HIGHLYRECOMMENDED ：该组件被高度推荐。

COMPONENT_VALUE_STANDARD ：该组件可以被包括也可以不包括。

COMPONENT_FIELD_FTPLOCATION ：在组件窗格中指定 FTP 位置属性的内容。

COMPONENT_FIELD_HTTPLOCATION ：在组件窗格中指定 HTTP 位置属性的内容。

COMPONENT_FIELD_STATUS （不针对脚本创建组件组）：文件传输过程中显示在进度指示器中的状态文本。这是保存在组件属性窗口中状态文本域中的值。

COMPONENT_FIELD_VISIBLE ：确定在一个组件选择对话框中组件是否可见。对于一个文件媒体库中的一个组件，这是保存在组件属性窗口中可见域的值。下列值之一将被设置到 nvResult ：

TRUE ：组件可见。
FALSE ：组件不可见。

COMPONENT_FIELD_PASSWORD （不针对脚本创建组件组）：是否有一个口令和组件相联系（在组件属性窗口中的口令域中）。下列值之一将被设置到 nvResult ：

TRUE ：该组件有一个口令。如果组件是口令保护的，你必须从最终用户处得到正确的口令并且在调用 ComponentTransferData 传输文件媒体库中的文件前用 ComponentValidata 检验它。
FALSE ：该组件没有一个口令。

COMPONENT_FIELD_SELECTED ：确定组件是否被选定：

TRUE ：该组件被选。
FALSE ：该组件没有被选。

COMPONENT_FIELD_SIZE （不针对文件媒体）：指定组件的原始文件大小。你也可以使用 ComponentGetItemSize 来确定一个组件（不包括子部件）的大小。使用 ComponentTotalSize 确定所有选定组件和子部件的总的大小。

COMPONENT_FIELD_MISC ：杂项文本。该域在运行时非常有用，因为你可以使用它用你希望的任何信息来标记或者标识组件。

COMPONENT_FIELD_DISPLAYNAME ：显示在组件选择对话框中的组件名。对于在文件媒体库中的组件，这是组件属性窗口中显示名称域的值。

COMPONENT_FIELD_CDROM_FOLDER （不针对脚本创建组件组）：仅对 CD-ROM 库类型。当"文件数据"在媒体向导的磁盘类型窗格中被检验时，指示与指定组件相联系的解压缩文件的位置。

nvResult

当 nInfo 产生一个数值型结果时返回一个数值型值。

svResult

当 nInfo 产生一个字符串型结果时返回一个字符串型值。

返回值：

0 ： ComponentGetData 成功。

< 0 ： ComponentGetData 失败。调用 ComponentError 查看附加信息。

7.8 ComponentGetItemSize

语法： ComponentGetItemSize (szMediaLibrary, szComponent, nvSize);

说明： ComponentGetItemSize 函数以字节数为单位检索一个指定组件的大小。子部件大小不包括在内。

该函数不能被使用到脚本创建组件组。

参数：

szMediaLibrary

指定包含了其大小要被检索的组件的文件媒体库的媒体名。

szComponent

指定其大小要被检索的组件的名称。

nvSize

以字节数为单位返回指定组件的大小。你也可以调用 ComponentGetData 来得到指定组件的原始文件的总的大小。调用 ComponentTotalSize 来确定所有被选组件和子部件的总的大小。

返回值：

0 ： ComponentGetItemSize 成功。

< 0 ： ComponentGetItemSize 失败。调用 ComponentError 查看附加信息。

7.9 ComponentGetTotalCost

语法： ComponentGetTotalCost (szMediaLibrary, szDir, nvTotalRequiredSpace);

说明： ComponentGetTotalCost 函数确定在目标驱动器上对已指定组件（例如，由最终用户在组件和安装类型对话框中选择）进行安装和卸载所需的总空间（以字节数为单位）。确定所需驱动器空间时，该函数考虑在目标驱动器上的簇的大小。

参数：

szMediaLibrary

指定其组件已经被指定来安装和卸载的文件媒体库的媒体名。典型地，你必须给该参数传递系统变量 MEDIA 。

szDir

指定使用的驱动器，或者被使用驱动器的路径，以此来确定所需的驱动器空间。

nvTotalRequiredSpace

返回所需的驱动器空间。

返回值：

0 ：表明函数成功确定所需驱动器空间。

<0 ：表明函数未能确定所需驱动器空间。

7.10 ComponentInitialize

语法： ComponentInitialize (szMediaLibrary, szMediaLibraryFile);

说明： ComponentInitialize 函数仅支持与 InstallShield 先前版本创建的脚本的兼容性。我们建议你不要在 InstallShield Professional 6.0 中使用多个文件媒体库。

ComponentInitialize 函数将一个媒体名和一个文件媒体库联系起来并且准备该媒体库被访问。该函数不能被使用到脚本创建的组件组。

参数：

szMediaLibrary

指定其文件要由 ComponentMoveData 传输的文件媒体库的媒体名。

szMediaLibraryFile

指定文件媒体库中的要被初始化的文件名。文件名必须是 xxx1.cab 的格式。不要指定一个路径；该文件必须驻留在安装资源文件夹（ SRCDIR ）。

返回值：

0 ： ComponentInitialize 成功。

< 0 ： ComponentInitialize 失败。

注解：

·在访问使用缺省媒体名 "Data" 的缺省文件媒体库 (Data1.cab) 之前，没有必要调用 ComponentInitialize 。缺省媒体在安装初始化过程中被自动初始化。文件媒体库必须驻留在安装资源文件夹。该文件夹的名称在安装初始化过程中被赋给系统变量 SRCDIR 。

·文件名必须是 xxx1.cab 格式；例如， second1.cab 或 wow1.cab 。

·媒体名 "Data" 被保留给和缺省文件媒体库 Data1.cab 一起使用。你不可以给参数 szMediaLibrary 传递 "Data" 。

7.11 ComponentIsItemSelected

语法： ComponentIsItemSelected (szComponentSource, szComponent);

说明： ComponentIsItemSelected 函数仅支持与 InstallShield 先前版本创建的脚本的兼容性。建议你把代码放置在组件事件处理器函数中来执行组件具体任务。

ComponentIsItemSelected 函数确定一具体组件是否被选定。该组件通常是由最终用户在一个组件选择对话框中选定的一个。

参数：

szComponentSource

指定其设置要被检验的文件媒体库或脚本创建组件组的媒体名。

szComponent

指定要被检验的组件名。

返回值：

TRUE (1) ： szComponent 被选定。

FALSE (0) ： SzComponent 没有被选定。

< 0 ：函数没有能确定组件是否被选定。调用 ComponetError 查看附加信息。

你也可以使用 ComponentGetData 来确定一个组件是否被选定。

7.12 ComponentListItems

语法： ComponentListItems (szComponentSource, szComponent, listComponents);

说明： ComponentListItems 函数罗列由 szComponentSource 指定的文件媒体库或脚本创建组件组中的所有组件到 szComponent 下。全限定子部件名列表保存在 listComponents 。如果 szComponent 没有孩子，则 listComponents 将是一个空列表。

参数：

szComponentSource

指定其子部件要被罗列的文件媒体库或脚本创建组件组的媒体名。

szComponent

指定其子部件要被罗列的组件。给该参数传递一个空字符串 ("") 来罗列所有顶层组件。有关函数调用中指定组件和子部件的更多信息，参阅前面。

listComponents

返回组件列表。由 listComponents 指定的字符串列表必须已经通过调用 ListCreat 被初始化。

返回值：

0 ： ComponentListItems 罗列组件。

< 0 ： ComponentListItems 不能罗列组件。调用 ComponentError 查看附加信息。

7.13 ComponentMoveData

语法： ComponentMoveData (szMediaLibrary, nvDisk, nReserved );

说明： ComponentMoveData 函数仅支持与 InstallShield 先前版本创建的脚本的兼容性。在一个基于事件的脚本中，文件传输自动被执行。（我们建议你把代码放置在组件事件处理器函数中来执行组件具体任务。）

ComponentMoveData 函数传输 / 解压缩与 szMediaLibrary 指定的文件媒体库中的被选组件相关联的文件。你可以在相同媒体上调用 ComponentMoveData 多次，但你必须在第二次和随后的调用前复位内部结构，可通过调用 ComponentMoveData 来实现复位（调用时将其第一个参数置为一个空字符串 ("") ）。

该函数不能被使用到脚本创建的组件组。

参数：

szMediaLibrary

指定其文件要被传输的文件媒体库的媒体名。

nvDisk

返回最后被访问的磁盘号。在调用 ComponentMoveData 前你不需要初始化 nvDisk 。

nReserved

给该参数传递 0 。不允许其它值。

返回值：

0 ： ComponentMoveData 成功。

< 0 ： ComponentMoveData 失败。调用 ComponentError 查看附加信息。

7.14 ComponentReinstall

语法： ComponentReinstall ( );

说明： ComponentReinstall 引起下一个对 ComponentTransferData 的调用会重新安装所有组件，这些组件在调用 ComponentTransferData 时已经被安装。 ComponentReinstall 通常在最终用户选择 SdWelcomeMaint 对话框中的"修复"按钮时的一个维护安装过程中被调用。

参数：

无。

返回值：

0 ：表明函数为重新安装作好准备。

<0 ：表明函数未能为重新安装作好准备。

7.15 ComponentRemoveAll

语法： ComponentRemoveAll ( );

说明：一个已经被运行的安装中，在 ComponentRemoveAll 函数被调用后，接下去对 ComponentTransferData 的调用将卸载安装。

参数：

无。

返回值：

0 ：表明函数成功准备卸载的初始化。

<0 ：表明函数没有能准备卸载的初始化。

7.16 ComponentSelectItem

语法： ComponentSelectItem (szComponentSource, szComponent, bSelect);

说明： ComponentSelectItem 函数仅支持与 InstallShield 先前版本创建的脚本的兼容性。我们建议你把代码放置在组件事件处理器函数中来执行组件具体任务。

ComponentSelectItem 函数设置一个组件的选定状态来选定或撤消选定。在组件对话框中显示组件之前，你可以使用 ComponentSelectItem 来修改选定状态，而且以后你可以根据你的需要使用它来修改或覆盖选择。

参数：

szComponentSource

指定其选定状态要被设置的组件所属文件媒体库或脚本创建组件集的媒体名。

szComponent

指定其选定状态要被设置的组件。

bSelected

指定组件是否要被选定或撤消选定。在该参数位置传递下列预定义常量之一：

TRUE ：选定指定的组件。

FALSE ：撤消选定指定的组件。

返回值：

0 ： ComponentSelectItem 成功设置项目的选定状态。

< 0 ： ComponentSelectItem 未能设置项目的选定状态。调用 ComponentError 查看附加信息。

7.17 ComponentSetData

语法： ComponentSetData (szComponentSource, szComponent, nInfo, nData, szData);

说明： ComponentSetData 函数为指定的组件设置属性和数据。对多数部分，设置和在组件属性窗口中的域设置相一致，从 InstallShield IDE 中的组件窗格中可达。注意一些域不能为脚本创建的组件组设置。

参数：

szComponentSource

指定其属性和数据要被设置的组件所属文件媒体库或脚本创建组件集的媒体名。

szComponent

指定组件名。

nInfo

指定要被设置的信息类型。在该参数位置传递下列预定义常量之一：

COMPONENT_FIELD_DESCRIPTION ：该文本被显示在组件选择对话框中的说明域。

COMPONENT_FIELD_FTPLOCATION ：一个 FTP 位置。

COMPONENT_FIELD_HTTPLOCATION ：一个 HTTP 位置。 .

COMPONENT_FIELD_STATUS ( 不适用与脚本创建组件 ) ：文件传输过程中该文本被显示在进度指示器中。

COMPONENT_FIELD_VISIBLE ：指示该组件是否可见。参数 nData 可为下列数之一：

TRUE ：组件可见。

FALSE ：组件不可见。

COMPONENT_FIELD_SELECTED ：设置组件的选定状态。该设置和 ComponentSelectItem 的效果一样。参数 nData 可以是下列数之一：

TRUE ：选定该组件项目。
FALSE ：撤消选定该组件项目。

COMPONENT_FIELD_SIZE ( 不对文件媒体库 ) ：组件的总的原始文件大小。

COMPONENT_FIELD_MISC ：杂项文本。

COMPONENT_FIELD_DISPLAYNAME ：确定在组件选择对话框中显示的组件名。

COMPONENT_FIELD_CDROM_FOLDER （不对脚本创建的组件组）：仅对 CD-ROM 分布媒体库。 CD 上的组件数据的定位。

COMPONENT_FIELD_IMAGE ：覆盖一个组件的缺省图标赋值。在 nData 传递显示的图标的索引。为指示组件不显示图标，在 nData 传递 -1 。

nData

当由 nInfo 指示的信息是数值时，指定一个数值型值。

szData

当由 nInfo 指示的信息是字符串时，指定一个字符串值。

返回值：

0 ： ComponentSetData 成功。

< 0 ： ComponentSetData 失败。调用 ComponentError 查看附加信息。

7.18 ComponentSetTarget

语法： ComponentSetTarget (szMediaLibrary, szPropertyVar, szLocation);

说明： ComponentSetTarget 函数将 szLocation 的值赋给由 szPropertyVar 指定的属性变量。属性变量可以在文件组窗口的 Destionation 域中和简捷属性窗口的 Target 域中使用。 SzLocation 的值必须是一个完整路径（包含驱动器字母和冒号）或一个部分路径，依赖于 szPropertyVar 如何被使用。你必须确认 szLocation 是路径表达式的正确形式。在调用 ComponentTransferData 之前调用 ComponentSetTarget 。

该函数不能被使用到脚本创建的组件组。

参数：

szMediaLibrary

指定要设置其用户定义的变量的文件媒体库的媒体名。

szPropertyVar

指定用户定义的变量。在 InstallShield IDE 中，用户定义的变量用 < 变量名 > 的格式。将用户定义的变量表示为一个字符串，包含中括号。例如：

szPropertyVar = "<szVar>";

szLocation

指定路径表达式来代替用户定义的变量。该字符串必须包含附加引号，即使它指定一个长路径。

返回值：

该函数总返回 0 。

7.19 ComponentSetupTypeEnum

语法： ComponentSetupTypeEnum (szMediaLibrary, listSetupTypes);

说明： ComponentSetupTypeEnum 函数列举所有和指定媒体相联系的安装类型。这些安装类型可以由你在 IDE 中定义并保存在文件媒体库中。 ComponentSetupTypeEnum 不能工作在脚本创建的组件组上。你必须使用 ListCreat 函数创建 listSetupTypes 字符串列表。

参数：

szMediaLibrary

指定安装类型要被列举的文件媒体库的媒体名。

listSetupTypes

返回一个在指定媒体上的所有安装类型的列表。由 listSetupType 标识的字符串列表必须已通过调用 ListCreate 被初始化。

返回值：

0 ： ComponentSetupTypeEnum 成功。

< 0 ： ComponentSetupTypeEnum 失败。

7.20 ComponentSetupTypeGetData

语法： ComponentSetupTypeGetData (szMediaLibrary, szSetupType, nInfo, nvResult, svResult);

说明： ComponentSetupTypeGetData 函数检索和一个指定的安装类型相联系的数据。然后你可以任意使用该数据。该函数不能被使用到脚本创建的组件组。

参数：

szMediaLibrary

指定文件媒体库的媒体名，从该库中检索和一个安装类型相关联的数据。

szSetupType

指定安装类型名。该名必须指定为和显示在 InstallShield IDE 中的完全一样，例如， " 典型 " 。

nInfo

指定要检索的信息。在该参数位置传递下列预定义常量之一：

SETUPTYPE_INFO_DESCRIPTION ：检索指定安装类型的说明。说明由参数 svResult 返回。

SETUPTYPE_INFO_DISPLAYNAME ：检索安装类型显示的名称。名称由参数 svResult 返回。

nvResult

当 nInfo 指定一个数值型或长整数型的信息时，返回该类型的值。

svResult

当 nInfo 指定一个字符串型的信息时，返回该类型的值。

返回值：

0 ： ComponentSetupTypeGetData 成功。

< 0 ： ComponentSetupTypeGetData 失败。调用 ComponentError 查看附加信息。

注解：

· ComponentSetupTypeGetData 的一个典型的应用可能是在一个自定义安装类型相关的对话框中显示安装类型信息。你将在显示自定义对话框的 WaitOnDialog 后在 switch-case 语句中调用 ComponentSetupTypeGetData 。

7.21 ComponentSetupTypeSet

语法： ComponentSetupTypeSet (szMediaLibrary, szSetupType);

说明： ComponentSetupTypeSet 函数设置在由 szMediaLibrary 指示的文件媒体库中的指定的安装类型。你可以使用 ComponentSetupTypeSet 来覆盖在一个安装类型对话框（如 SdSetupTypeEx ）中所作的选择。

该函数不能使用到脚本创建的组件组。

参数：

szMediaLibrary

指定要设置安装类型的文件媒体库的媒体名。

szSetupType

指定设置为何种安装类型。

返回值：

0 ： ComponentSetupTypeSet 成功。

< 0 ： ComponentSetupTypeSet 失败。

7.22 ComponentTotalSize

语法： ComponentTotalSize (szMediaLibrary, szComponent, bIncludeSubcomp, bTargetSize);

说明： ComponentTotalSize 函数以字节数返回由 szComponent 指定的被选组件的总的大小。为在大小计算中包含子部件，设置 bIncludeSubcomp 为 TRUE 。为得到指定媒体中所有组件的总的大小，设置 szComponet 为一个空字符串 ("") 并设置 bIncludeSubcomp 为 TRUE 。

如果你将 ComponentTotalSize 的返回值和显示在 SdComponentDialog, SdComponentDialog2, SdComponentDialogAdv 和 SdComponentMult 对话框中的的所需空间值比较，你可能注意到一个小的差异。该差异归根于当这些对话框计算它们的值时发生的舍入。

参数：

szMediaLibrary

指定文件媒体库的文件名，从该媒体库中被选定的组件的总的大小被返回。

szComponent

指定其大小要被检索的组件名。为检索整个媒体的大小，给该参数传递一个空字符串 ("") 。有关函数调用中组件和子部件的更多信息，同前面。

bIncludeSubcomp

指示是否要包括 szComponent 的选择的子部件。在该参数位置传递下列预定义常量之一：

TRUE ：在大小计算中包括选择的子部件。

FALSE ：在大小计算中不包括选择的子部件。

bTargetSize

指示是否要检索原始 / 非压缩大小或媒体库的大小。在该参数中传递下列预定义常量之一：

TRUE ：检索原始 / 非压缩大小；

FALSE ：检索在媒体库中的大小。

返回值：

XXXX ：被选定组件的总的大小（字节数）。

< 0 ： ComponentTotalSize 失败。调用 ComponentError 查看附加信息。

7.23 ComponentTransferData

语法： ComponentTransferData (szMediaLibrary);

说明：在一个基于事件的脚本中， ComponentTransferData 函数在 First UI Before 事件后被自动调用，并和 Moving 、 Moved 和组件事件进行适当交互。 ComponentTransferData 根据组件的选定状态和当前是否被安装来适当安装或卸载组件。 ComponentTransferData 做到下列事情：

安装被选定的（例如，最终用户在组件或安装类型对话框中的选择）并且当前没有安装的组件。
卸载没有被选定并且当前已安装的组件。

安装程序通过读现存的安装初始化过程中的日志文件来确定一个组件当前是否是被安装的。

参数：

szMediaLibrary

指定其组件已经被指定来安装或卸载的文件媒体库的媒体名。典型地，你可以传递系统变量 MEDIA 给该参数。

返回值：

0 ：表明函数成功执行组件的安装和卸载。

<0 ：表明函数没有能执行组件的安装和卸载。

7.24 ComponentUpdate

语法： ComponentUpdate ( );

说明： ComponentUpdate 引起下一个对 ComponentTransferData 的调用来重新安装所有已经在调用 ComponentTransferData 时被安装的组件，除了那些包含有维护安装时和卸载时所需的文件的组件（注意这些组件由媒体生成器自动放置到你的 .cab 文件，而不是显示在 IDE 中）。 ComponentUpdate 通常在一个修补程序或维护组件安装中被调用。

ComponentUpdate 和 ComponentReinstall 相似，但 ComponentReinstall 也重新安装那些包含有维护安装时和卸载时所需的文件的组件。

参数：

无。

返回值：

0 ：表明函数成功准备好更新安装。

<0 ：表明函数未能准备好更新安装。

7.25 ComponentValidate

语法： ComponentValidate (szMediaLibrary, szComponent, szPassword);

说明： ComponentValidate 函数验证文件媒体库或一个指定组件的口令。

该函数不能被使用到脚本创建的组件组。

参数：

szMediaLibrary

指定要验证口令的文件媒体库名。

szComponent

指定组件名。如果该参数是一个空字符串 ("") ，则假定为整个媒体库。有关函数调用中组件和子部件的更多信息请参阅 7.1 。

szPassword

指定要验证的口令。

返回值：

0 ： ComponentValidate 成功。

< 0 ： ComponentValidate 失败。调用 ComponentError 查看附加信息。

7.26 SdSetupType

请参阅 5.27

7.27 SdSetupTypeEx

请参阅 5.28

8 文件配置函数

8.1 高级配置文件函数

高级配置文件函数比 Ez 配置文件函数提供给高级开发人员更大的灵活性和对系统配置的更多控制。为使用这些高级函数访问和编辑一个系统配置文件，可通过调用 ConfigFileLoad 开始。大多数其它函数只有在系统配置文件已经由 ConfigFileLoad 打开后才能被调用。当你结束编辑系统配置文件时，调用 ConfigFileSave 来保存你的修改。注意函数 ConfigGetFileName 和 ConfigSetFileName 既可以和高级配置文件函数也可以和 Ez 配置文件函数一起使用。

不要把 Ez 配置文件函数和高级配置文件函数混合起来。调用 ConfigFileLoad 之后，直到你调用了 ConfigFileSave 保存你的修改后，你才能使用 Ez 配置文件函数。

ConfigAdd

添加一个语句到一个已经被装入内存的系统配置文件。

ConfigDelete

从一个系统配置文件中删除一项。

ConfigFileLoad

把一个系统配置文件装入内存来编辑。

ConfigFileSave

保存一个已经由 ConfigFileLoad 装入内存的系统配置文件。

ConfigFind

在一个系统配置文件中查找一个项目。

ConfigGetFileName

检索缺省系统配置文件的全限定名。

ConfigGetInt

从一个系统配置文件中检索一个值。

ConfigMove

在一个系统配置文件中移动一项。

ConfigSetFileName

指定一个系统配置文件的全限定名。

ConfigSetInt

在系统配置文件中设置一个值。

相关函数

SdShowFileMods

创建一个对话框，提议修改文件和提供如何进行的选项。

11.1 AddProfString

语法： AddProfString (szFileName, szSectionName, szKeyName, szValue);

说明： AddProfString 函数无条件地添加一个配置字符串到一个 .ini 文件。使用 AddProfString 仅添加非唯一键，如那些在 System.ini 文件的 [386Enh] 段找到的 (device = ...) 。 AddProfString 添加 KEY=VALUE 行到指定的 .ini 文件的段的结尾。它不置换或更新一个现存键。为更新一个现存的非唯一键，调用 ReplaceProfString 。为在一个 .ini 文件中添加一个唯一键或更新一个唯一键的值，调用 WriteProfString 。

　　对 .ini 文件所做的修改可以存入到卸载记录中。然而，必须知道一些重要的限制。更多信息，可查看卸载 .ini 文件的条目。

参数：

szFileName

指定要添加配置字符串的 .ini 文件的名称。如果 szFileName 是未限定名（也就是，不包括一个驱动器指示符和路径）， InstallShield 在 Windows 文件夹中查找该文件。如果文件不存在，它被在指定文件夹中创建，如果文件名中不包括路径，该文件被创建在 Windows 文件夹中。注意如果文件名限定在一个不存在的路径中， AddProfString 将失败。

szSectionName

指定 .ini 文件中的一个段名。配置字符串被插入在该段的结尾。如果该段不存在， InstallShield 创建它。段名必须不被包围在定界中括号中（ [ ] ）。注意即使该段中由 szKeyName 指定的键已经存在，配置字符串仍被插入。

szKeyName

指定要插入的键名。该参数的值将显示在配置字符串中等号左边。

szValue

指定赋给该键的值。该参数的值将显示在配置字符串中等号右边。

返回值：

0 ： AddProfString 成功添加指定的配置字符串到 .ini 文件。

< 0 ： AddProfString 未能添加指定的配置字符串到 .ini 文件。

注解：

AddProfString 不使用 Windows API 来修改 .ini 文件。 Windows API 不能处理用 AddProfString 可能实现的修改类型。

11.2 GetProfInt

语法： GetProfInt (szFileName, szSectionName, szKeyName, nvValue);

说明： GetProfInt 函数从一个 .ini 文件中检索一个整数。参数 nDefault 指定为 0 时， GetProfInt 和 Windows API GetPrivateProfileInt 一样工作。

参数：

szFileName

指定一个 .ini 文件名，从中得到一个键的当前整型值。如果 szFileName 是未限定名（也就是，不包括一个驱动器指示符和路径）， InstallShield 在 Windows 文件夹中查找该文件。

szSectionName

指定 .ini 文件中的一个段名，从中查找 szKeyName 。段名必须不被包围在定界中括号中（ [ ] ）。

查找该名称时不区分大小写。

szKeyName

指定一个键，其整型值被返回到 nvValue 。查找该键不区分大小写。

nvValue

返回一个当前赋给 szKeyName 的整型值。由于 GetPrivateProfileInt 函数的限制，该函数只可以从该配置文件中返回一个 16 位的值。

因此，可以被返回的最大值是 65,535 ；更大的值可能不会被正确返回。如果你需要返回一个更大的值，使用通常的文件处理函数，如 FileGrep 和 FileInsertLine ，然后通过调用 StrToNum 把返回的字符串转换成一个整型值。

返回值：

GetProfInt 总返回 0 。

注解：

·如用 Windows API 函数 GetPrivateProfileInt 一样，如果因不能找到文件，段或键名而发生的错误不会被返回；而是 nvValue 包含 0 。因此，不可能辨别一个错误和一个 0 的返回值。为辨别 0 和一个错误，直接调用 GetPrivateProfileInt 并指定一个候选的缺省值。

·在 Windows NT （不是 Windows 95 及更高版本）下，一些对 GetPrivateProfileInt 函数（因此也是 GetProfInt 函数）的调用被自动映象到 Windows 注册表而不是配置文件。

11.3 GetProfString

语法： GetProfString (szFileName, szSectionName, szKeyName, svResult);

说明： GetProfString 函数从一个指定的 .ini 文件中检索一个配置字符串。 GetProfString 和 Windows API GetPrivateProfileString 一样工作。

参数：

szFileName

指定一个 .ini 文件名，从中得到一个键的当前值。如果 szFileName 是未限定名（也就是，不包括一个驱动器指示符和路径）， InstallShield 在 Windows 文件夹中查找该文件。

szSectionName

指定 .ini 文件中的一个段名，从中查找 szKeyName 。段名必须不被包围在定界中括号中（ [ ] ）。

查找该段名时不区分大小写。为得到一个 INI 文件中的所有段名列表，给该参数传递一个空字符串。更多信息请看下面的注解。

szKeyName

指定一个键，它的值被返回到 svResult 。查找该键时不区分大小写。为得到一个段中所有键名的列表，给该参数传递一个空字符串。更多信息请看下面的注解。

svResult

如果 szSectionName 指定一个段名， szKeyName 指定一个键名，该键的值被返回到该参数。如果 szSectionName 指定一个空字符串，所有段名返回到 svResult 。如果 szKeyName 指定一个空字符串，该段中的所有键名返回找 svResult 。

返回值：

0 ： GetProfString 成功返回配置字符串的值。

< 0 ： GetProfString 未能返回配置字符串的值。

-2 ：该键的值的长度超过 2048 个字符（可以由 GetProfString 返回到 svResult 的最大字符数）。

注解：

·为得到一个 INI 文件中所有段名的列表，该参数 szSectionName 传递一个空字符串。由空字符定界的段名返回到参数 svResult 。 SvResult 必须足够长来接受所有的段名。使用 StrGetTokens 函数来从该字符串中析取单个段名。

·为得到由 szSectionName 指定的段中的所有键名的列表，给参数 szKeyName 传递一个空字符串。由空字符定界的键名返回到参数 svResult 。 SvResult 必须足够长来接受所有的键名。使用 StrGetTokens 函数来从该字符串中析取单个键名。

· GetProfString 使用你的操作环境的 API 提供的函数来访问 .ini 文件。因此， InstallShield 的函数功能性可能受操作环境的限制。

11.4 GetProfStringList

语法： GetProfStringList (szFileName, szSectionName, listKeyNames, listValues);

说明： GetProfStringList 函数从指定的 INI 文件中的指定段中检索键名和字符串值列表。

参数：

szFileName

指定一个 .ini 文件名，从中得到键名和字符串值。如果 szFileName 是未限定名（也就是，不包括一个驱动器指示符和路径）， InstallShield 在 Windows 文件夹中查找该文件。

szSectionName

指定 .ini 文件中的一个段名，从中查找键名和字符串值。段名必须不被包围在定界中括号中（ [ ] ）。查找该段名时不区分大小写。

listKeyNames

返回一个键名列表。由 listKeyNames 标识的字符串列表必须已经通过调用 ListCreate 而被初始化。

listValues

返回一个字符串值的列表。由 listValues 标识的字符串列表必须已经通过调用 ListCreate 而被初始化。

返回值：

0 ：表明函数成功读段并将键名和字符串值插入到指定列表中。

-2 ：表明一个或所有列表的 ID 是无效的。其它负值表明函数未能读段或未能将键名和字符串值插入到指定列表中。

11.5 ReplaceProfString

语法： ReplaceProfString (szFileName, szSectionName, szKeyName, szOrigValue,

szReplaceValue);

说明： ReplaceProfString 函数置换 .ini 文件中的一个配置字符串。该函数可以置换重复键（非唯一键）的值，如在 System.ini 文件中 [386Enh] 段中找到的那些 (device = ...) 。该函数查找一个 szKeyName = szOrigValue, ，并置换该行。如果它没有找到，它就在 szSectionName 段开始添加 zKeyName = szReplaceValue 行。

　　如果你添加唯一键（就是，对一个给定的段，所有键都不同），使用 WriteProfString 函数。使用该函数只置换非唯一键名，如 System.ini 文件中的 device= 行。

　　对 .ini 文件所做的修改可以存入卸载记录中。然而，必须知道一些重要的限制。更多信息，可查看卸载 .ini 文件的条目。

参数：

szFileName

指定要置换配置字符串的 .ini 文件的名称。如果 szFileName 是未限定名（也就是，不包括一个驱动器指示符和路径）， InstallShield 在 Windows 文件夹中查找该文件。如果文件不存在，它被在指定文件夹中创建，如果文件名中不包括路径，该文件被创建在 Windows 文件夹中。注意如果文件名限定在一个不存在的路径中， ReplaceProfString 将失败。

szSectionName

指定 .ini 文件中的一个段名，从中查找 szKeyName 。段名必须不被包围在定界中括号中（ [ ] ）。查找该段名时不区分大小写。

szKeyName

指定要被置换的键名。如果该键不存在，则被创建。

szOrigValue

标识由 szKeyName 指定的键的当前值。

szReplaceValue

指定赋给 szKeyName 的新值。该参数的值将显示在配置字符串 (szKeyName = szValue) 等号右边。

返回值：

0 ：表明函数成功置换或添加配置字符串。

< 0 ：表明函数未能置换或添加配置字符串。

注解：

· Windows .ini 是文本文件。你必须在每个操作系统中使用 InstallShield 的合适版本。

11.6 WriteProfInt

语法： WriteProfInt (szFileName, szSectionName, szKeyName, iValue);

说明： WriteProfInt 函数通过插入或更新一个配置字符串（整型值赋给键），来修改一个 .ini 文件。注意下列要点：

因为 Windows 高速缓存保存文件的方法改变，你必须在调用 WriteProfString 后刷新高速缓存。（看下面的注解部分。）

对 .ini 文件所做的修改可以存入到卸载记录中。然而，必须知道一些重要的限制。更多信息，可查看卸载 .ini 文件的条目。
为写一个字符串值到一个 .ini 文件，则调用 WriteProfString 。
当你想修改 System.ini 文件时使用 AddProfString 和 ReplaceProfString 函数。

参数：

szFileName

szSectionName

指定 .ini 文件中的一个段名， szKeyName 将要被插入其中或将要被修改。段名必须不被包围在定界中括号中（ [ ] ）。查找该段名时不区分大小写。

szKeyName

指定要更新的唯一键。如果要被更新的键不存在于指定段中，则它被创建。

为从一个 .ini 文件中删除一整个段，给参数 szKeyName 传递一个空字符串。为从一个 .ini 文件的一个段中删除一个或多个键，使用 WriteProfString 。

iValue

指定赋给由 szKeyName 标识的唯一键的整型值。

返回值：

0 ：表明函数成功更新指定的 .ini 文件。

< 0 ：表明函数未能更新指定的 .ini 文件。

注解：

· WriteProfInt 函数使用 Windows API WritePrivateProfileString 来访问 .ini 文件。因此，它的函数功能性受 Windows API 提供的函数功能的限制。 .ini 文件的更多信息可查询 Microsoft Windows 手册。

· .ini 文件在 Windows 95 及更高版本下被放在高速缓存中，这种特性可能导致延迟将修改写到指定文件。这接着可能妨碍随后的文件操作，如调用 CopyFile 和 XCopyFile 。因此如果你随后要用到文件操作，则你必须在使用 WriteProfInt 后，刷新高速缓存。简单地以空参数调用 WriteProfInt 来强制 Windows 95 及更高版本立即写数据到 .ini 文件，如下所示：

WriteProfInt ("c:\\test.ini", "Windows", "KeyboardDelay", 100);

WriteProfInt ("","","",0); //null string ("") in first three parameters

//CopyFile should now have access to updated file.

CopyFile ("c:\\test.ini", "d:\\test.ini");

11.7 WriteProfString

语法： WriteProfString (szFileName, szSectionName, szKeyName, szValue);

说明： WriteProfString 函数写一个配置字符串到一个 .ini 文件。根据传递给 WriteProfString 的值，它可以创建一个段，删除一整个段，创建一个唯一的 KEY=VALUE 条目，删除一个 KEY=VALUE 条目，或更新一个键的值。

注意要点同 WriteProfInt 中的注意要点。

参数：

szFileName

指定 .ini 文件的名称。如果 szFileName 是未限定名（也就是，不包括一个驱动器指示符和路径）， InstallShield 在 Windows 文件夹中查找该文件。如果文件不存在，它被在指定文件夹中创建，如果文件名中不包括路径，该文件被创建在 Windows 文件夹中。注意如果文件名限定在一个不存在的路径中， Write ProfString 将失败。

szSectionName

指定 .ini 文件中的一个段名， szKeyName 将要被插入其中或将要被修改。段名必须不被包围在定界中括号中（ [ ] ）。查找该段名时不区分大小写。

szKeyName

指定要更新或删除的唯一键。如果要被更新的键不存在于指定段中，则它被创建。为删除该键，给参数 szValue 传递一个空字符串。为删除由 szSectionName 指定的整个段（包括它里面的所有条目），给参数 szKeyName 传递一个空字符串。

szValue

指定赋给由 szKeyNamw 标识的唯一键的值。为删除该键，给该参数传递一个空字符串。为删除该键的值而保留键本身，则给该键传递一个空格。

返回值：

0 ：表明函数成功写字符串到指定的 .ini 文件。

< 0 ：表明函数未能写字符串到指定的 .ini 文件。

注解：

请参阅 WriteProfInt 的注解。

12 共享和锁定文件函数

　　一个共享文件是一个可以被多个应用程序使用的文件，如 .dll ， .vbx 或驱动程序。 InstallShield 保护共享文件在卸载过程中不被删除。

　　使用 SHAREDFILE 选项的函数把所有的文件都视为共享文件，因而为所有包含的文件递增注册表引用计数器。如果文件存在于目标目录并且它的注册表引用计数器大于０，则 InstallShield 将其注册表引用计数器增一。如果共享文件不存在于目标目录并且它没有引用计数器， InstallShield 创建该计数器并设置它为１。如果共享文件已经存在于目标目录当没有引用计数器， InstallShield 创建该计数器并初始化它为２，作为防止在卸载过程中意外删除的预防措施。

　　共享文件当它们被锁定时不能被更新。一些 InstallShield 文件传输函数使用 SHAREDFILE 选项，因而在文件传输过程中被锁定的 .dll 和 .exe 文件可以被记录并在 Windows 或系统重启时被更新。

　　 InstallShield 将一个正被一个应用程序或系统使用的文件视为锁定。锁定文件不必要是共享文件。

下列函数处理共享和锁定文件：

请参阅 3.9 。

RebootDialog

请参阅 4.9 。

SdFinishReboot

请参阅 5.17 。

VerUpdateFile

请参阅 21.5 。

XCopyFile

请参阅 9.28 。

13 字符串函数

　　字符串函数提供处理字符串变量和文字的功能。字符串函数与标准 C 语言函数相似。返回值也遵守 C 语言的规定。

CopyBytes

从一个字符串中拷贝指定字节数到另一个。

GetDir

从一个路径名或全限定文件名中删除驱动器标识。

GetDisk

从一个路径名或全限定文件名中检索磁盘驱动器标识。

NumToStr

将一个数字转换为一个字符串。

ParsePath

从一个路径中检索驱动器，路径，文件名或扩展名。

StrCompare

将一个字符串和另一个比较。

StrFind

在另一个字符串中查找一个字符串。

StrGetTokens

基于指定定界符从一个字符串中得到一个令牌。

StrLength

返回一个字符串中的字节数。

StrLengthChars

返回一个字符串中的字符数。

StrRemoveLastSlash

删除一个路径字符串中的最后的反斜杠。

StrSub

从一个字符串中返回一个子串。

StrToLower

转换字符串中的所有字母字符为小写。

StrToNum

转换字符串为一个数字。

StrToUpper

转换字符串中的所有字母字符为大写。

13.1 CopyBytes

语法： CopyBytes (svDest, nIndexDest, svSrc, nIndexSrc, nCount);

说明： CopyBytes 函数从一个字符串中拷贝指定的字节数到另一个字符串。你可以在源和目标字符串中指定偏移下标。

参数：

svDest

指定目标字符串。

nIndexDest

指定在目标字符串中的偏移下标（开始点），从这个位置开始插入这些字节。字符串的第一个字节是在位置 0 。

svSrc

指定源字符串。不要传递一个大小大于 256 个字符的自动调整大小的字符串。而应该用一个显式大小声明字符串。 nIndexSrc

指定源字符串的偏移下标（开始点），从这个位置开始拷贝这些字节。字符串的第一个字节是在位置 0 。

nCount

指定你要从 svSrc 拷贝到 svDest 的总的字节数。该值必须不大于 svSrc-1 的大小。例如，如果 svSrc 被声明为大小为 512 （给它最大字符串长度 511 ），则传递给 nCount 的值必须是 511 或更少。

返回值：

0 ： CopyBytes 成功地从一个字符串拷贝指定数目的字节到另一个字符串。

< 0 ： CopyBytes 没有能拷贝这些字节。

注解：

当你工作在二进制文件时， CopyBytes 有用。

13.2 GetDir

语法： GetDir (szPath, svDir);

说明： GetDir 函数从由 szPath 指定的全限定路径或文件名中删除驱动器指示符，并在参数 svDir 返回路径或文件名的余项。路径名必须包含一个驱动器指示符。它可以是一个 UNC （通用导航计算机）路径。

在下面的例子中，全限定路径 C:\Windows 在 svDir 返回为\ Windows 。

GetDir("C:\\Windows", svDir);

在下一个例子中， UNC 路径 \\TheServer\TheSharedDevice\Programs 在 svDir 返回为\ Programs 。

GetDir("\\\\TheServer\\TheSharedDevice\\Programs", svDir);

参数：

szPath

指定包含一个驱动器指示符的路径。

svDir

返回没有驱动器指示符的路径。如果 szPath 是一个 UNC 路径， GetDir 将返回没有服务器名和共享设备名的路径。

返回值：

0 ：表明函数成功返回没有驱动器指示符的路径名。

<0 ：表明函数未能返回没有驱动器指示符的路径名。

13.3 GetDisk

语法： GetDisk (szPath, svDisk);

说明： GetDisk 函数从由 szPath 指定的全限定路径或文件名中析取磁盘驱动器指示符。

参数：

szPath

指定一个包含一个驱动器指示符的全限定路径或文件名。如果不包含一个驱动器指示符， GetDisk 将失败。传递给 szPath 的值可以是一个 UNC 路径。

svDisk

返回驱动器指示符（包含冒号）。如果 szPath 是一个 UNC 路径， GetDisk 以 " <\\服务器\共享设备> " 格式返回服务器名和共享设备名。

返回值：

0 ：表明函数成功返回驱动器指示符。

< 0 ：表明函数未能返回驱动器指示符。

13.4 NumToStr

语法： NumToStr (svString, nValue);

说明： NumToStr 函数将一个数字转换为一个字符串。

参数：

svString

返回 nValue 的字符串等价值（等效字符串）。

nValue

指定要转换为一个字符串的数字。

返回值：

0 ：表明函数成功将数字转换为一个字符串。

< 0 ：表明函数未能将数字转换为一个字符串。

13.5 ParsePath

语法： ParsePath (svReturnString, szPath, nOperation);

说明： ParsePath 函数检索一个存在路径的指定部分。函数可工作于任何有效路径，包括短路径，长路径和 UNC 路径，它们可能包含或不包含一个具体文件名。下面是可以用该函数分析的一些路径样本：

\ Path1\Path2\Filename.exe

Filename

Filename.exe

\Path1\Path2\Filename

D:\

\\Server Name\Share Name\Share Directory

其它任何合法 DOS 路径。

参数：

svReturnString

返回参数 szPath 中的路径由参数 nOperation 所指定的部分。

szPath

指定要分析的路径。当指定一个不包含一个文件名的路径时，你必须在把它传递给 ParsePath 之前在路径结尾添加一个反斜杠；否则路径的最后部分会被解释为一个文件名。

nOperation

指定返回路径的哪个元素。在该参数位置传递下列预定义常量之一：

DIRECTORY ：表明必须在 svReturnString 返回路径中去除磁盘驱动器字符和文件名。当该选项使用在一个 UNC 路径时， ParsePath 返回没有服务器和共享设备名的路径，并且没有文件名（可能被指定）。例如， UNC 路径 \\TheServer\TheSharedDevice\TheApp\TheFile.exe 在 svReturnString 返回\ TheApp\ 。

DISK ：表明必须在 svReturnString 返回磁盘驱动器指示符（驱动器字符后随一个冒号）。当该选项使用在一个 UNC 路径时， ParsePath 返回服务器名和共享设备名。例如， UNC 路径 \\TheServer\TheSharedDevice\TheApp\TheFile.exe 在 svReturnString 返回\\ TheServer\TheSharedDevice 。

EXTENSION_ONLY ：表明必须在 svReturnString 返回文件扩展名。它不包括句点。

FILENAME ：表明必须在 svReturnString 返回完整的文件名（也就是说，包括它的文件扩展名）。

FILENAME_ONLY ：表明必须在 svReturnString 仅返回文件名（也就是说，不包括它的文件扩展名）。

PATH ：表明必须在 svReturnString 返回路径中去除文件名。该选项和 DIRECTORY 不同，因为驱动器指示符（如果在 szPath 中被指定）包括在返回路径中。当 szPath 指定一个 UNC 路径时，服务器名和共享设备名被包括在返回路径中。例如， UNC 路径 \\TheServer\TheSharedDevice\TheApp\TheFile.exe 在 svReturnString 返回 \\TheServer\TheSharedDevice\TheApp\ 。

返回值：

0 ：表明函数成功分析路径字符串。

< 0 ：表明函数未能分析路径字符串。

13.6 StrCompare

语法： StrCompare (szStringA, szStringB);

说明： StrCompare 函数比较两个字符串。比较不区分大小写。

参数：

szStringA

指定要比较的第一个字符串。

szStringB

指定要比较的第二个字符串。

返回值：

< 0 ：表明 szStringA 的字符串的值小于 szStringB 的字符串的值。

= 0 ：表明两个字符串相等。

> 0 ：表明 szStringA 的字符串的值大于 szStringB 的字符串的值。

注解：

· StrCompare 函数比较两个字符串，通过检验每个字符串中的第一个字符，然后每个字符串中的第二个字符，以次类推，直到它找到一个不相等的字符或到达了字符串结尾。

·你选择的语言的语言驱动程序确定哪个字符串大或字符串相等。如果你不使用一个语言驱动程序， Windows 使用一个内部函数。对于一个双字节字符集（ DBCS ）版本的 Windows ，该函数可以比较两个 DBCS 字符串。

13.7 StrFind

语法： StrFind (szString, szFindMe);

说明： StrFind 函数确定传递给参数 szFindMe 的字符串能否在传递给参数 szString 的字符串中找到。如果 szFindMe 在 szString 中找到， StrFind 返回 szFindMe 的第一个字符在 szString 中的位置。注意 szString 中第一个字符的位置是 0 。该函数不区分大小写并且只可以用来找到 szFindMe 在 szString 中首次出现。

下面的例子中， StrFind 将返回值 13 。

nStartPos = StrFind("Scripting is fun","fun");

如果只需要一个 TRUE 或 FALSE 的返回值来指示一个字符串是否包含另一个字符串，（也就是，如果子串的位置是不重要的），使用字符串查找操作符（ % ），如下所示：

if (szString % szFindMe) then ...

在 if 语句中可以被解析的布尔表达式中，你可以只使用字符串查找操作符。你不能在 repeat 语句或 while 语句中使用它。

参数：

szString

指定要查找的字符串。

szFindMe

指定要在 szString 中查找的字符串。

返回值：

X ：如果 szString 包含 szFindMe ， X 是 szFindMe 中第一个字符的数值位置。 SzString 中第一个字符是在位置 0 。

< 0 ：表明 szString 不包含 szFineMe 。

13.8 StrGetTokens

语法： StrGetTokens (listID, szString, szDelimiterSet);

说明： StrGetTokens 函数从 szString 指定的字符串中析取子串（称为令牌）并且把它们放置到 listID 指定的列表中。 SzString 中的子串必须被由 szDelimiterSet 指定的一个或多个字符分隔（相互分隔）。

例如，如果你调用 StrGetTokens ，字符串 "One;Two;Three;Four;Five" 作为第二个参数， ";" 为第三个参数， "One", "Two", "Three", "Four", 和 "Five" 这五个字符串将被返回到 listID 。使用列表函数，如 ListGetFirstString 和 ListGetNextString 来访问列表中的每个令牌。

如果 szString 中的第一个字符与 szDelimiterSet 中的一个字符匹配，一个空字符串将被插入为列表的第一个元素。同样，如果 szString 中的最后一个字符与 szDelimiterSet 中的一个字符匹配，一个空字符串将被插入为列表的最后一个元素。

参数：

listID

返回令牌列表。由 listID 标识的字符串列表必须已经通过对 ListCreate 的调用而初始化。

szString

指定要被分析的字符串。

szDelimiterSet

指定一个或多个分隔符的集合。每个分隔符是一个字符（ 1 字节）。如果你在该参数传递一个空字符串，该函数以空字符为分隔符来查找。当你使用 GetProfString 函数时有用。

当一个空格被指定为分隔符， StrGetTokens 将连续的空格处理作一个单独的分隔符。

返回值：

0 ：表明函数成功分隔字符串并把令牌 (token) 插入到指定列表中。

< 0 ：表明函数未能分隔字符串并把令牌插入到指定列表中。

13.9 StrLength

语法： StrLength (szString);

说明：使用 StrLength 函数得到一个字符串中的字节数。为确定一个字符串中的字符数，使用 StrLengthChars 。

参数：

szString

指定要确定其大小的字符串。

返回值：

X ： X 是字符串中的字节数。

< 0 ：表明函数未能确定字符串中的字节数。

13.10 StrLengthChars

语法： StrLengthChars (szString);

说明：使用 StrLengthChars 函数得到一个字符串中的字符数。为确定一个字符串中的字节数，使用 StrLength 。

参数：

szString

指定要确定其大小的字符串。

返回值：

X ： X 是字符串中的字符数。

< 0 ：表明函数未能确定字符串中的字符数。

13.11 StrRemoveLastSlash

语法： StrRemoveLastSlash (svPath);

说明： StrRemoveLastSlash 函数从一个路径说明中删除结尾反斜杠。

参数：

svPath

指定一个字符串，其值必须是一个路径说明；返回没有结尾反斜杠的路径。注意如果路径不包含一个反斜杠，它不作修改就被返回。

返回值：

0 ：表明函数成功删除结尾反斜杠或路径不包含一个结尾反斜杠。

< 0 ：表明函数未能删除结尾反斜杠。

注解：

· StrRemoveLastSlash 给将 AskPath 或 ParsePath 返回的路径剪裁掉结尾反斜杠提供了一个便利的途径。因为它的目的是产生一个有效路径名， StrRemoveLastSlash 不从一个根目录说明中删除反斜杠，如 "A:\" 或 "C:\" ；这样做可将一个有效路径名转换到一个驱动器说明（标识）。你是否需要在任何情况下剪裁掉一个路径的结尾反斜杠，可参考下面的脚本片段。

AskPath("", "", svPath);

if (StrLength(svPath) = 3)

&& (svPath[1] = ":")

&& (svPath[2] = "\\") then

svTempString = svPath;

StrSub(svPath,svTempString,0,2);

else

StrRemoveLastSlash(svPath);

endif;

13.12 StrSub

语法： StrSub (svSubStr, szString, nStart, nLength);

说明： StrSub 函数拷贝 szString 指定的字符串的部分，从 nStart 指定的位置开始。参数 nLength 指定要拷贝的字符数。

参数：

svSubStr

返回从 szString 拷贝的子串。

szString

指定要从中拷贝子串的字符串。

nStart

指定一个 szString 中的偏移量来标识要被拷贝的第一个字符。注意 szString 中的第一个字符的位置是 0 。如果传递给 nStart 的值等于或大于 szString 的长度，在 svSubStr 返回一个空字符串。

nLength

指定从 szString 拷贝的字符数。如果该值指定了多于 nStart 和 szString 结尾之间的字符数，在 svSubStr 返回从 nStart 到字符串结尾的所有字符。

返回值：

X ： X 等于 svSubStr 的字符数。

13.13 StrToLower

语法： StrToLower (svTarget, szSource);

说明： StrToLower 函数将一个字符串中的所有字母转换为小写。该函数不影响非字母字符。

参数：

svTarget

返回 szSource 中的字符串，其所有字符均已转换为小写。

szSource

指定均要转换为小写字符的字符串。

返回值：

0 ：表明函数成功修改了字符串的大小写。

< 0 ：表明函数未能修改了字符串的大小写。

13.14 StrToNum

语法： StrToNum (nvVar, szString);

说明： StrToNum 函数将一个字符串转换为一个数字，与 C 函数 atol() 相似。它检查 svString ，从位置 0 的字符开始，在字符串中继续直到它到达字符串结尾或遇到一个不在 "0".."9" 范围内的一个字符。（字符串中的第一个字符可能是一个加号或减号。）将出现下列处理过程：

如果字符串中的所有字符在 "0".."9" 范围中，由字符串代表的数字赋给 nvVar 。
如果字符串以一个或多个 "0".."9" 范围内的字符开始但也包含一个或多个非数字字符，则将出现的第一个非数字字符的左边的所有字符赋给 nvVar 。例如，如果 szString 是 "-123ABC456", nvResult 将是 -123 。
如果字符串的第一个字符不在 "0".."9" 范围内并且不是一个加号或减号，该函数失败。
如果字符串的第一个字符是一个加号或减号，并且第二个字符不在 "0".."9" 范围内，该函数失败。

参数：

nvVar

返回从 szString 的字符串生成的数字。

szString

指定要转换为一个数字的字符串。

返回值：

0 ：表明函数成功将字符串转换为数值型值。

< 0 ：表明函数未能将字符串转换为数值型值。

13.15 StrToUpper

语法： StrToUpper (svTarget, szSource);

说明： StrToUpper 函数将一个字符串中的所有字母转换为大写。该函数不影响非字母字符。

参数：

svTarget

返回 szSource 中的字符串，其所有字符均已转换为大写。

szSource

指定均要转换为大写字符的字符串。

返回值：

0 ：表明函数成功修改了字符串的大小写。

< 0 ：表明函数未能修改了字符串的大小写。

14 路径缓冲函数

路径缓冲函数有助于你处理包含查找路径的字符串。路径缓冲函数工作在一个唯一的作为路径缓冲的临时字符串变量。该路径缓冲在 InstallShield 内部被定义；所有路径字符串函数对路径缓冲中的内容起作用。

这些函数不支持长文件名。在将长文件名传递到一个路径缓冲函数前调用 LongPathToShortPath 将它转换到等价的短文件名。

路径函数帮助你操作和创建路径字符串。你一旦创建一个路径字符串，你可以把它保存到合适的文件中。

PathAdd

将一个路径添加到路径缓冲中的查找路径。

PathDelete

从路径缓冲中删除一个目录。

PathFind

在路径缓冲中找到一个特定路径或任何包含一个特定名称的路径。

PathGet

检索路径缓冲的当前值。

PathMove

重新整理路径缓冲。

PathSet

分配一个值给路径缓冲。

14.1 PathAdd

语法： PathAdd (szDir, szRefDir, bRefDir, bPosition);

说明： PathAdd 函数添加一个路径到路径缓冲中的查找路径。使用该函数你可以指定和路径缓冲中的一个现存目录相关联的目录位置。另外，你可以添加该路径作为路径缓冲中的第一个或最后一个目录。

　　该函数和 Autoexec.bat 文件中的路径语句或路径环境变量无关。它仅作用在路径缓冲，帮助你创建，修改和操作查找路径。然后你可以通过使用不同的批处理文件函数将修改的路径缓冲字符串添加到 Autoexec.bat 文件。该函数不支持长文件名。在将长文件名传递到一个路径缓冲函数前调用 LongPathToShortPath 将它转换到等价的短文件名。

参数：

szDir

指定要添加到路径缓冲中的路径。

szRefDir

指定当前路径缓冲中与将要被添加的新路径相关的路径。

bRefDir

指定 szRefDir 是否是一个全限定路径。在该参数位置传递下列预定义常量之一：

FULL ： SzRefDir 是一个全限定路径（也就是，包括一个驱动器指示符和到一个目录的完整路径）。

PARTIAL ： SzRefDir 仅是目录名（没有驱动器和路径信息）。

bPosition

指定 szDir 要被插入到的相对于 szRefDir 的位置。在该参数位置传递下列预定义常量之一：

AFTER ：指定 szDir 被插入到 szRefDir 之后。如果 szRefDir 指定一个空字符串， szDir 被插入到路径缓冲中的路径结尾。

BEFORE ：指定 szDir 被插入到 szRefDir 之前。如果 szRefDir 指定一个空字符串， szDir 被插入到路径缓冲中的路径前面。

返回值：

0 ：表明函数成功添加一个目录到路径缓冲。

< 0 ：表明函数未能添加一个目录到路径缓冲。

注解：

·如果你在 szDir 指定了一个当前已经存在于路径缓冲中的目录， InstallShield 将复制它，并且前面存在的目录位置不被修改。 InstallShield 忽略在目录名结尾的反斜杠。

14.2 PathDelete

语法： PathDelete (szDir, bDir);

说明： PathDelete 函数删除路径缓冲中的一个特定路径。你可以指定路径名或输入一个全限定路径。

　　该函数和 Autoexec.bat 文件中的路径语句或路径环境变量无关。它仅作用在路径缓冲，帮助你创建，修改和操作查找路径。调用 PathGet 得到路径缓冲中的内容，调用 PathSet 设置路径缓冲中的内容。该函数不支持长文件名。在将长文件名传递到 PathDelete 前调用 LongPathToShortPath 将它转换到等价的短文件名。

参数：

szDir

指定要从路径缓冲中删除的路径。

bDir

指定 szRefDir 是否是一个全限定路径。在该参数位置传递下列预定义常量之一：

FULL ： SzRefDir 是一个全限定路径（也就是，包括一个驱动器指示符和到一个目录的完整路径）。

PARTIAL ： SzRefDir 仅是目录名（没有驱动器和路径信息）。

返回值：

0 ：表明函数成功从路径缓冲中删除一个目录。

< 0 ：表明函数未能从路径缓冲中删除一个目录。

14.3 PathFind

语法： PathFind (szDir, svResult, bDir, bSearch);

说明： PathFind 函数从路径缓冲中查找一个特定目录。你可以以一个全限定名或仅目录名来指定目录。

　　该函数和 Autoexec.bat 文件中的路径语句或路径环境变量无关。它仅作用在路径缓冲，帮助你创建，修改和操作查找路径。然后你可以通过使用不同的批处理文件函数添加该临时路径字符串到 Autoexec.bat 文件。该函数不支持长文件名。在将长文件名传递到 PathFind 前调用 LongPathToShortPath 将它转换到等价的短文件名。

参数：

szDir

指定要在路径缓冲中查找的路径。

svResult

返回由该函数返回的路径缓冲中的完整目录和路径。

bDir

指定 szRefDir 是否是一个全限定路径。在该参数位置传递下列预定义常量之一：

FULL ： SzRefDir 是一个全限定路径（也就是，包括一个驱动器指示符和到一个目录的完整路径）。

PARTIAL ： SzRefDir 仅是目录名（没有驱动器和路径信息）。

bSearch

指定从哪儿开始查找。在该参数位置传递下列预定义常量之一：

CONTINUE ：从路径缓冲中的前一个查找结束处继续查找。

RESTART ：从路径缓冲的开头开始查找。

返回值：

0 ：表明函数在路径缓冲中成功查找一个目录。

< 0 ：表明函数在路径缓冲中未能查找到一个目录。

14.4 PathGet

语法： PathGet (svString);

说明： PathGet 函数检索当前保存在路径缓冲（一个由调用 PathSet 所创建的临时存储区）中的查找路径。路径缓冲使你能创建和编辑一个查找路径。当你编辑完路径，调用 PathGet 把查找路径放置到一个字符串变量，因而你可以把它传递到你的安装程序中的其它函数。

参数：

svString

返回路径缓冲中的内容。

返回值：

0 ：表明函数成功检索当前保存在路径缓冲中的路径。

< 0 ：表明函数未能检索当前保存在路径缓冲中的路径。

注解：

PathGet 从路径缓冲中检索查找路径并释放分配给路径缓冲的内存。除非通过调用 PathSet 来重新初始化路径缓冲，否则随后对 PathGet 的调用将会失败。

14.5 PathMove

语法： PathMove (szDir, szRefDir, bDir, bRefDir, bPosition);

说明： PathMove 函数重新定位路径缓冲中的一个目录到另一个位置。你也可以使用该函数来定位一个目录，相对于另一个目录或作为路径字符串中的第一项或最后一项。

调用 PathGet 得到路径缓冲中的内容，调用 PathSet 设置路径缓冲中的内容。该函数和 Autoexec.bat 文件中的路径语句或路径环境变量无关。它仅作用在路径缓冲，帮助你创建，修改和操作查找路径。然后你可以通过使用不同的批处理文件函数添加该临时路径字符串到 Autoexec.bat 文件。该函数不支持长文件名。在将长文件名传递到 PathMove 前调用 LongPathToShortPath 将它转换到等价的短文件名。

参数：

szDir

指定在路径缓冲中重新定位的完整路径或部分路径。

szRefDir

指定当前路径缓冲中和将要被移动的 szDir 中的路径相关的路径。为移动 szDir 中的路径到路径缓冲中路径的开始或结尾，给该参数传递一个空字符串。

bDir

指定 szDir 是否是一个全限定路径。在该参数位置传递下列预定义常量之一：

FULL ：表明 szDir 包含一个全限定目录名。

PARTIAL ：表明 szDir 仅包含目录名。

bRefDir

指定 szRefDir 是否是一个全限定路径。在该参数位置传递下列预定义常量之一：

FULL ：表明 SzRefDir 包含一个全限定路径名。

PARTIAL ：表明 SzRefDir 仅包含目录名。

bPosition

指定 szDir 要被插入到的相对于 szRefDir 的位置。在该参数位置传递下列预定义常量之一：

AFTER ：指定 szDir 被插入到 szRefDir 之后。如果 szRefDir 指定一个空字符串， szDir 被插入到路径缓冲中的路径结尾。

BEFORE ：指定 szDir 被插入到 szRefDir 之前。如果 szRefDir 指定一个空字符串， szDir 被插入到路径缓冲中的路径前面。

返回值：

0 ：表明函数成功在路径缓冲中重新定位一个目录。

< 0 ：表明函数未能在路径缓冲中重新定位一个目录。

14.6 PathSet

语法： PathSet (szString);

说明： PathSet 函数保存一个查找路径字符串到路径缓冲中。然后你可以使用其它路径函数来操作该缓冲。 szString 的值必须是一个绝对路径。

该函数和 Autoexec.bat 文件中的路径语句或路径环境变量无关。它仅作用在路径缓冲，帮助你创建，修改和操作查找路径。然后你可以通过使用不同的批处理文件函数添加该临时路径字符串到 Autoexec.bat 文件。该函数不支持长文件名。在将长文件名传递到 PathSet 前调用 LongPathToShortPath 将它转换到等价的短文件名。

参数：

szString

指定一个要保存在路径缓冲中的查找路径。该查找路径必须是全限定的；也就是它必须包含一个驱动器指示符和到一个目录的完整路径。

返回值：

0 ：表明函数成功保存一个查找路径到路径缓冲中。

< 0 ：表明函数未能保存一个查找路径到路径缓冲中。

15 注册表函数

下列函数允许你访问注册表，读、创建和删除注册表项，和为卸载建立注册表相关参数。

CreateCreateInstallationInfo

为你安装的程序创建一个应用程序信息项和一个每应用程序路径项。

CreateRegistrySet

创建在资源窗格的注册表入口文件夹中指定注册表入口的一组或所有组。

DeinstallSetReference

指定在卸载进程开始前要检测的参考文件。

DeinstallStart

创建应用程序卸载项和设置该项下的 [UninstallString] 值。

InstallationInfo

根据公司名、产品名和产品版本号来创建注册表项。

MaintenanceStart

通过创建注册表项来激活卸载功能。

RegDBConnectRegistry

打开到一个远程注册表的连接。

RegDBCreateKeyEx

在注册表中创建一项。也允许你将一个类对象和一个注册表项联系起来（仅对高级用户）。

RegDBDeleteKey

从注册表中删除指定项。

RegDBDeleteValue

从一个指定注册表项中删除一个值。

RegDBDisConnectRegistry

关闭到一个远程注册表的连接。

RegDBGetAppInfo

在一个应用程序信息项下检索一个值。

RegDBGetItem

在每应用程序路径项或应用程序卸载项下检索值。

RegDBGetKeyValueEx

从注册表的一项中检索一个值。

RegDBKeyExist

检测注册表项的存在。

RegDBQueryKey

对一项的子项和值名进行排队。

RegDBSetAppInfo

设置应用程序信息项下的一个值。

RegDBSetDefaultRoot

设置开关键。

RegDBSetItem

在每应用程序路径项或应用程序卸载项下赋值。

RegDBSetKeyValueEx

设置注册表入口。

SetInstallationInfo

指定 CreateInstallationInfo 使用的公司和产品信息。

15.1 CreateRegistrySet

语法： CreateRegistrySet (szRegistrySet);

说明： CreateRegistrySet 函数创建由当前媒体中的一个或所有注册表组指定的注册表信息。当前媒体的名称保存在系统变量 MEDIA 中。一个注册表组可以和一个文件组相联系，因此仅当文件组已经被安装到目标系统上时，对 CreateRegistrySet 的调用才创建注册表组。如果你正使用一个基于事件的脚本 , 任何和一个或多个文件组相联系的注册表组（使用注册表组的文件组属性）当安装那些文件组的任何一个时 , 它都被自动创建。

参数：

SzRegistrySet

指定当前媒体上的注册表组名。为创建所有当前媒体上定义的注册表组，给该参数传递一个空字符串。

返回值：

0 ：表明函数成功。

-7 ：创建一项失败。

-8 ：不能设置一个注册表项的值。

-9 ：文本替换失败。

-10 ：内存溢出。

-11 ：未能从字符串表中取得一个值。

-12 ：该函数在当前媒体上调用 ComponentTransferData 之前被调用。注意 ComponentTransferData 在一个运行基于事件的脚本的安装中被自动调用。

-13 ：未知错误。

注解：

·系统变量 MEDIA 的值在安装初始化过程中被设置为' DATA '。如果你修改该变量的值来指向一个脚本创建的组件组，则你在调用 CreateRegistrySet 之前必须把值修改回' DATA '。

·该函数仅在已经调用 ComponentTransferData 后才能被调用。

15.2 CreateInstallationInfo

语法： CreateInstallationInfo ( );

说明：在一个基于事件的脚本中， CreateInstallationInfo 函数在 First UI Before 事件之后被自动调用。它使用已经由 SetInstallationInfo 指定的信息来创建你正在安装的程序的一个应用程序信息项和每应用程序路径项。应用程序信息项作为调用 InstallationInfo 的结果立即被创建。每应用程序路径项则直到随后调用 RegDBSetItem 设置该项下的一个 [Path] 或 [DefaultPath] 值后才被创建。

CreatInstallationInfo 提供显示在欢迎对话框中的产品名，也提供 MaintenanceStart 使用来初始化卸载日志文件的公司名，产品名和版本号。如果脚本中在 MaintenanceStart 之前没有调用 CreateInstallationInfo ，则 MaintenanceStart 将失败。在一个安装中只能调用 CreateInstallationInfo 一次。如果你运行多个使用 DoInstall 的安装，每个安装当然可以有它自己的对 CreateInstallationInfo 的调用。 CreateInstallationInfo 是一个特殊的注册表相关函数，设计为处理特定的预定义注册表项。

参数：

无。

返回值：

0 ：表明函数成功。

< 0 ：表明函数未能创建一个或多个注册表项。

注解：

·你必须在调用下列要使用由 SetInstallationInfo 提供的信息的函数之前调用 CreateInstallationInfo ： RegDBSetAppInfo, RegDBGetAppInfo, RegDBSetItem, RegDBGetItem 。更多信息可查看这些函数的说明。

·由传递给 SetInstallationInfo 的值指定的每应用程序路径项直到调用 RegDBSetItem 设置该项下的值之后才真正被创建。

DeinstallSetReference

语法： DeinstallSetReference (szReferenceFile);

说明：指定在卸载进程开始前要检测的参考文件。如果该文件正被使用，卸载不执行。最终用户必须关闭使用该文件的进程并再开始卸载。你必须在调用 DeinstallSetReference 前调用 DeinstallStart 。

因为 Windows 和 Windows 应用程序中的特定限制，在很少情况下一个由 DeinstallSetReference 指定的文件可能看似被锁定。

参数：

szReferenceFile

指定在卸载进程开始前要检测的文件的全限定名。该文件是只被要卸载的应用程序使用的一个程序或一个 DLL 。

返回值：

0 ：表明函数成功。

< 0 ：表明函数失败。

注解：

·为指定要检测的多个文件，可为每个文件调用该函数。不要指定一个正被操作系统或其它应用程序使用的文件；如果你这么做，最终用户将不能继续卸载。

15.4 DeinstallStart

语法： DeinstallStart (szObsolete, svObsolete, szObsolete, lReserved);

说明： DeinstallStart 函数仅支持和由 InstallShield 先前版本创建的脚本兼容。我们建议你使用 MaintenanceStart 函数来代替。

DeinstallStart 函数通过在注册表项 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\ CurrentVersion\Uninstall\<PRODUCT_GUID> 下创建下列值来激活卸载功能：

UninstallString 系统变量 UNINST 的值

DisplayName 传递给 InstallationInfo 第二个参数的值

LogFile <DISK1TARGET>\Setup.ilg

DeinstallStart 在一个安装脚本中必须只被执行一次。然而，如果你运行多个使用 DoInstall 的脚本，那么你可以在一个安装中调用 DeinstallStart 多次，因为每个单个脚本可以调用 DeinstallStart 一次。

参数：

szObsolete

该参数的值被忽略。

svObsolete

你必须给该参数传递一个字符串值。不返回有用信息。

szObsolete

该参数的值被忽略。

lReserved

给该参数传递 0 。不允许其它值。

返回值：

0 ：表明函数成功创建注册表项值。

< 0 ：表明函数未能创建一个或多个注册表项值。

注解：

· RegDBSetItem 和 RegDBGetItem 函数设置和检索应用程序卸载项下的卸载图标名（ [DisplayName] 值），它由调用 DeinstallStart 函数创建。因此，根据要被设置或检索的值， RegDBSetItem 和 RegDBGetItem 要求在它们被使用之前调用 DeinstallStart 。

·在调用任何使用 SHAREDFILE 或 LOCKEDFILE 选项的函数前，并在调用 SdFinishReboot 前，应用程序信息项必须用 InstallationInfo 创建，应用程序卸载项必须用 DeinstallStart 函数创建。

· Enable(LOGGING) 激活记录卸载信息。缺省时它被激活；你需要调用 Enable(LOGGING) 仅更正前一个 Disable(LOGGING) 调用的影响。

15.5 InstallationInfo

语法： InstallationInfo (szCompany, szProduct, szVersion, szProductKey);

说明： InstallationInfo 函数指定一个公司名，一个产品名，一个产品版本号和一个程序可执行文件名。你指定的信息被用来为你安装的程序创建一个应用程序信息项和一个每应用程序路径项。应用程序信息项作为调用 InstallationInfo 的结果立即被创建。每应用程序路径项则直到随后调用 RegDBSetItem 设置该项下的一个 [Path] 或 [DefaultPath] 值后才被创建。

InstallationInfo 提供显示在欢迎对话框中的产品名。 InstallationInfo 提供 DeinstallStart 使用来初始化卸载日志文件的公司名，产品名和版本号。如果脚本中在 DeinstallStart 之前没有调用 InstallationInfo ，则 DeinstallStart 将失败。

在一个安装中只能调用 InstallationInfo 一次。如果你运行多个使用 DoInstall 的安装，每个安装当然可以有它自己的对 InstallationInfo 的调用。

InstallationInfo 是一个特殊的注册表相关函数，被设计来处理特定的预定义注册表项。

参数：

szCompany

指定公司名。 InstallShield 使用 szCompony 来在注册表中的 [HKEY_LOCAL_MACHINE] \ Software 项下创建一个\ <company> 项。

szProduct

指定要被安装的产品名。 InstallShield 使用 szProduct 来在注册表中的 [HKEY_LOCAL_ MACHINE]\Software\<company> 项下创建一个\ <product> 项。 SzProduct 的值也被插入到欢迎对话框中的消息文本的第一段中。

szVersion

指定产品的版本号。 InstallShield 使用 szVersiont 来在注册表中的 [HKEY_LOCAL_MACHINE] \ Software\<company>\<product> 项下创建一个\ <version> 项。合在一起，\ <company> 项 (szCompany), \<product> 项 (szProduct), 和\ <version> 项 (szVersion) 被指定为应用程序信息项。应用程序信息项在调用 InstallationInfo 时立即被创建。

szProductKey

应用程序的主可执行文件的文件名。如果你使用几个可执行文件，指定最能代表产品的可执行文件。 InstallShield 使用 szProductKey 来在项 [HKEY_LOCAL_MACHINE]\Software \ Microsoft\Windows\CurrentVersion\App Paths 下创建一个每应用程序路径项。每应用程序路径项知道你调用 RegDBSetItem 创建该项下的一个数值名和数值数对后才真正在注册表中被创建。

返回值：

0 ：表明函数成功。

< 0 ：表明函数未能如设置那样使用参数。确认你使用了正确的语法。该函数的任何参数都不允许空字符串。

注解：

·你必须在调用下列函数之前调用 InstallationInfo ，因为它们使用 InstallationInfo 提供的信息： RegDBSetAppInfo, RegDBGetAppInfo, RegDBSetItem, RegDBGetItem 。更多信息请查看这些函数的说明。

·由传递给 InstallationInfo 的值指定的每应用程序路径项直到调用 RegDBSetItem 设置该项下的值之后才真正被创建。

15.6 MaintenanceStart

语法： MaintenanceStart ( );

说明： MaintenanceStart 函数创建在维护安装或卸载的初始化过程中使用的一个注册表项和相应值，并为添加 / 删除程序对话框提供应用程序信息。如果你使用一个基于事件的脚本， MaintenanceStart 在 First UI Before 事件后被自动调用。

MaintenanceStart 在注册表项 HKEY_LOCAL_MACHINE\Software\Microsoft\Windows \ CurrentVersion\Uninstall\<PRODUCT_GUID> 下创建下列值：

UninstallString 系统变量 UNINSTALL_STRING 的值。

DisplayName 传递给 SetInstallationInfo 或 InstallationInfo 的第二个参数的值。

(SetInstallationInfo 函数在 Begin 事件之前被自动调用，它的第二个参数等于 PRODUCT_NAME 字符串表入口。 )

LogFile <DISK1TARGET>\Setup.ilg

参数：

无。

返回值：

0 ：表明函数成功创建注册表项和它相应值。

< 0 ：表明函数未能创建注册表项和它相应值。

15.7 RegDBConnectRegistry

语法： RegDBConnectRegistry (szRemoteSystem, nKeyType, nReserved);

说明： RegDBConnectRegistry 函数创建一个到一个远程注册表的连接。如果你试图打开一个远程 Windows NT 系统的注册表，你必须拥有管理员的特权。如果你试图打开一个远程 Windows 95 和更高的系统的注册表，则必须已经激活了远程管理。该函数是给系统管理员使用来进行网络安装的。

一旦你已经打开了连接，你可以象对一个本地注册表一样对一个远程注册表进行创建、删除或检索注册表项、数值名和数值对。 RegDBConnectRegistry 允许你每次打开远程注册表时只编辑一个注册表开关键，你只可以编辑 HKEY_LOCAL_MACHINE 或 HKEY_USERS 下的项和值。当你调用 RegDBConnectRegistry 时，你必须指定你希望能编辑哪个开关键。如果你想要编辑另一个开关键或它的一个子项，你必须关闭并重新打开该连接。

为编辑一个远程注册表，你必须只使用通用注册表相关函数（如下所列），它们被设计为可以处理所有注册表项：

RegDBCreateKeyEx 、 RegDBDeleteKey 、 RegDBDeleteValue 、 RegDBGetKeyValueEx

RegDBKeyExist 、 RegDBQueryKey 、 RegDBSetKeyValueEx

参数：

szRemoteSystem

指定要连接的系统名，如 "RemoteSys" 。

nKeyType

指定下列常量之一：

HKEY_LOCAL_MACHINE 或 HKEY_USERS.

nReserved

给该参数传递 0 。不允许其它值。

返回值：

0 ：表明函数成功建立一个到系统注册表的连接。

REGDB_ERR_CONNECTIONEXISTS (-6) ：一个到一个远程注册表的连接早已存在。在你再次调用 RegDBConnectRegistry 之前必须用 RegDBDisConnectRegistry 关闭它。

REGDB_ERR_CORRUPTEDREGISTRY (-4) ：表明远程注册表被破坏，不能被访问。

REGDB_ERR_INITIALIZATION (-2) ：表明注册表服务不能被初始化。确认远程管理已经被激活并且你有可以写注册表的适当特权。

REGDB_ERR_INVALIDHANDLE (-5) ：提供给远程注册表的项名不被允许。

REGDB_ERR_INVALIDNAME (-3) ：表明在 szRemoteSystem 中的系统不能被找到。检查名称并重试。

-1 ：其它错误。

注解：

·自从你通过调用 RegDBConnectRegistry 设置了开关键，一旦你已经建立了一个到远程注册表的连接，你就不能调用 RegDBSetDefaultRoot 。一旦你已经调用了 RegDBDisConnectRegistry ，所有对注册表相关函数的调用都会影响本地注册表，并且然后你可以调用 RegDBSetDefaultRoot 来修改开关键。

· 在一个卸载中， InstallShield 将卸载为存入卸载记录中的任何项下的所有项。由 InstallShield 自动创建的项将为存入卸载记录。当你调用 RegDBSetKeyValueEx 创建项，在这些项以上没有存入卸载记录的项，你的项不会被卸载掉，不管存入是否被激活（你可以 Enable 和 Disable 登记）。然而，当你调用 RegDBCreateKeyEx 来创建一个项，当存入被激活时，该项上没有存入卸载记录的项，你的项会存入卸载记录。当存入项被删除时，你创建在该项下的所有项会被卸载。更多信息可查询各个函数的说明。

15.8 RegDBCreateKeyEx

语法： RegDBCreateKeyEx (szKey, szClass);

说明： RegDBCreateKeyEx 函数创建注册表中的一项。你也可以将一个类对象和新创建的项联系起来（仅对高级用户）。新创建的项没有一个和它相联系的值。除非你另外指定， InstallShield 将该项创建为 HKEY_CLASSES_ROOT 的子项。你可以使用 RegDBSetDefaultRoot 来指定一个不同的开关键。

在一个项 - 子项表达式中用一个双反斜杠来分隔不同层。如果它们不存在时， InstallShield 将立即创建所有层。

　　当存入功能被激活时，由 RegDBCreateKeyEx 创建的项存入卸载记录。然而，记住在一个多项表达式如 Key1\Key2\Key3 中， RegDBCreateKeyEx 识别 Key3 为该函数调用所关系的项。如 DOS 命令 DIR C:\Windows\System 列出 Windows 系统文件夹中的文件，而不是 Windows 文件夹中的。因此， Key3 将被存入到卸载记录，但 Key1 和 Key2 不会。有关 Windows 系统文件夹的信息，请查阅 InstallShield 系统变量 WINSYSDIR 的文档。

　　为在 RegDBCreateKeyEx 创建一个项和子项时确保正确地存入卸载记录，首先创建父项（存入功能激活时）。当项的链中父项或高层项被创建后，然后创建父项下的子项。被各自创建的父项的下面所有子项当父项被卸载时也会被卸载。

例如，为确保 Key1 和所有它的子项会被卸载，首先当存入被激活时用 RegDBCreateKeyEx 创建 Key1 。然后你可以在一个单独的函数调用中或在各自的函数调用中创建 Key2,Key3 等等项。当 Key1 被卸载，它下面的所有子项将被卸载。

　　记住当一个项被卸载时，它的所有子项也被卸载。因此，如果你使用 RegDBCreateKeyEx 来创建一个已经被存入卸载记录的项下的项，那么当更高层的项被卸载时你所创建的项也被卸载，不管当你创建你的项时存入功能是否被激活，也不管你以什么次序创建你的项。

　　如果你正用 RegDBCreateKeyE 创建的项已经存在并且你没有禁用存入功能，则其它应用程序使用的项将被存入卸载记录。在一个卸载过程中，该项将被卸载，这给那些使用该项的应用程序造成问题。为避免该问题，在创建一个项前用 RegDBKeyExist 来检测它的存在性。如果该项已经存在，使用 RegDBCreateKeyEx 来创建一个对你的应用程序唯一的子项。然后，当卸载发生时，只有子项被删除。如果你不希望首先检测项的存在性，当你创建该项时，你可以使用 Disable 函数来禁用存入功能。在项被创建后再激活存入功能。然而，记住该项不会和你的应用程序一个被卸载。

RegDBCreateKeyEx 是一个通用注册表相关函数，设计为可工作于所有注册表项，包括那些由特殊注册表相关函数处理的项。

参数：

szKey

指定要在四个开关键中的一个之下创建的项的名称。用一个双反斜杠来分隔子项中的不同层。

szClass

指定和该项相联系的类名。

返回值：

0 ：表明函数成功创建该子项。

< 0 ：表明函数未能创建该子项。

注解：

· Windows NT 4.0 不允许在 HKEY_LOCAL_MACHINE 下直接创建一个项。

15.9 RegDBDeleteKey

语法： RegDBDeleteKey (szSubKey);

说明： RegDBDeleteKey 函数从注册表中删除一个特定项和与它相联系的值。被删除项的所有子项及与它们相联系的值也被删除。

InstallShield 假定由 szSubKey 指定的项是 HKEY_CLASSES_ROOT 的一个子项。你可以使用 RegDBSetDefaultRoot 来指定另一个开关键。

RegDBDeleteKey 是一个通用注册表相关函数，设计为可工作于所有注册表项，包括那些由特殊注册表相关函数处理的项。

参数：

szSubKey

指定要删除的项的名称。用一个双反斜杠来分隔子项中的不同层。

返回值：

0 ：表明函数成功删除该项。

< 0 ：表明函数未能删除该项。

15.10 RegDBDeleteValue

语法： RegDBDeleteValue (szSubKey, szValue);

说明： RegDBDeleteValue 函数从一个注册表的一个特定项中删除一个值。 InstallShield 假定由 szSubKey 指定的项是 HKEY_CLASSES_ROOT 的一个子项。你可以使用 RegDBSetDefaultRoot 来指定另一个开关键。

参数：

szSubKey

指定注册表项的名称，该项包含要删除的值名。用一个双反斜杠来分隔子项中的不同层。

szValue

指定你要删除的值的名称。

返回值：

0 ：表明函数成功删除该值。

< 0 ：表明函数未能删除该值。

15.11 RegDBDisConnectRegistry

语法： RegDBDisConnectRegistry (nReserved);

说明： RegDBDisConnectRegistry 函数关闭调用 RegDBConnectRegistry 建立的到一个远程注册表的一个连接。

调用 RegDBDisConnectRegistry 后，所有对安装脚本注册表相关函数的调用都会影响本地系统注册表。更多信息请查阅特殊注册表相关函数。

参数：

nReserved

给该参数传递 0 。不允许其它值。

返回值：

0 ：表明函数成功关闭一个到远程系统上的注册表的连接。

< 0 ：表明函数未能关闭注册表连接。

15.12 RegDBGetAppInfo

语法： RegDBGetAppInfo (szName, nvType, svValue, nvSize);

说明： RegDBGetAppInfo 函数从注册表中检索你的主应用程序的应用程序信息项下的一个特定数值名的值。应用程序信息项由 InstallShield 创建，作为调用 InstallationInfo 的结果。在调用 RegDBGetAppInfo 之前，你必须调用 InstallationInfo 来创建一个应用程序信息项。

RegDBGetAppInfo 是一个特殊的注册表相关函数，被设计来处理特定的预定义注册表项。

参数：

szName

指定要检索的值的数值名。

nvType

返回下列预定义常量之一，它们标识在 svValue 返回的数据的类型：

REGDB_STRING ：字符串变量，不允许换行符。

REGDB_STRING_EXPAND ：字符串变量保持一种可扩展的环境变量表达式，如 "%MYPATH%" 。

REGDB_STRING_MULTI ：字符串变量，允许换行符。

REGDB_NUMBER ：看作为一个字符串的数字表达式，并可传递给字符串变量。

REGDB_BINARY ：将二进制数据保存在一个字符串中。

svValue

返回由 szName 指定的数值名的值。

nvSize

以字节数返回返回值的大小。

返回值：

0 ：表明函数成功检索该值。

< 0 ：表明函数未能检索该值。

15.13 RegDBGetItem

语法： RegDBGetItem (nItem, svValue);

说明： RegDBGetItem 函数根据 nItem 的值检索每应用程序路径项或应用程序卸载项下的值。这些项 InstallShield 创建，作为调用 InstallationInfo 的结果。在调用 RegDBGetItem 之前，你必须调用 InstallationInfo 来创建一个应用程序信息项。

RegDBGetItem 是一个特殊的注册表相关函数，被设计来处理特定的预定义注册表项。

参数：

nItem

指定要检索的项。在该参数位置传递下列预定义常量之一：

REGDB_APPPATH ：每应用程序路径项下 [Path] 的值。

REGDB_APPPATH_DEFAULT ：每应用程序路径项下 [DefaultPath] 的值。

REGDB_UNINSTALL_NAME ：卸载项下 [DisplayName] 的值。当该常量被使用时， szValue 指定显示在控制面板中可卸载应用程序列表中的应用程序名。

svValue

返回该项的值。

返回值：

0 ：表明函数成功检索该项目的值。

< 0 ：表明函数未能检索该项目的值。确认你在使用该函数之前使用了 InstallationInfo 函数。

注解：

·在调用 RegDBGetItem 函数（ nItem 为 REGDB_APPPATH 或 REGDB_APPPATH_DEFAULT 选项）前，你必须用 InstallationInfo 函数创建每应用程序路径项。在调用 RegDBGetItem 函数（ nItem 为 REGBD_UNINSTALL_NAME ）前，你必须调用 DeinstallStart 函数来创建卸载项，并给应用程序卸载项下的 [DisplayName] 赋一个值。

15.14 RegDBGetKeyValueEx

语法： RegDBGetKeyValueEx (szKey, szName, nvType, svValue, nvSize);

说明： RegDBGetKeyValueEx 函数检索注册表中一个指定项下一个特定数值名的值。缺省时， InstallShield 假定该项是 HKEY_CLASSES_ROOT 下的一个子项。你可以用 RegDBSetDefaultRoot 来指定另一个开关键。

RegDBGetKeyValueEx 是一个通用注册表相关函数，设计为可工作于所有注册表项，包括那些由特殊注册表相关函数处理的项。

参数：

szKey

指定其值要被检索的项的名称。用一个双反斜杠来分隔子项中的不同层。

szName

指定在 szKey 下其值要被检索的数值的数值名。要检索项的缺省值，则传递一个空字符串。

nvType

返回下列预定义常量之一，它们标识在 svValue 返回的数据的类型：

请参阅 15.12 中该部分的说明。

svValue

返回由 szKey 和 svName 指定的值。注意一个数值型值以一个字符串返回。

nvSize

以字节数返回在 svValue 返回的值的大小。

返回值：

0 ：表明函数成功检索该值。

< 0 ：表明函数未能检索该值。

注解：

一个 Windows NT 平台上，当检索 REGDB_STRING_MULTI 数据类型时，带空字符串为参数调用 StrGetTokens 来将多个以空字符串为中止的字符串分析到一个字符串列表。也就是，如果 svValue 在调用 RegDBGetKeyValueEx 后有多个结果字符串， StrGetTokens( listID, svValue, "") 可以被使用来分析字符串并把它们放到一个由 listID 指向的字符串列表。

15.15 RegDBKeyExist

语法： RegDBKeyExist (szSubKey);

说明： RegDBKeyExist 函数检测注册表中一个特定项的存在性。缺省时， InstallShield 假定该项是 HKEY_CLASSES_ROOT 下的一个子项。你可以用 RegDBSetDefaultRoot 来指定另一个开关键。

RegDBKeyExist 是一个通用注册表相关函数，设计为可工作于所有注册表项，包括那些由特殊注册表相关函数处理的项。

参数：

szSubKey

指定要查找的项的名称。你不必要在该参数包括 HKEY_CLASSES_ROOT 项（或你指定的其它项）。用一个双反斜杠来分隔子项的不同层。

返回值：

1 ：表明函数成功找到注册表中的项。

< 0 ：表明函数未能找到注册表中的项。

15.16 RegDBQueryKey

语法： RegDBQueryKey (szSubKey, nItem, listResults);

说明： RegDBQueryKey 函数允许用户排队一个项的子项和值名。使用该函数可以在运行时动态列举这些项。

RegDBQueryKey 是一个通用注册表相关函数，设计为可工作于所有注册表项，包括那些由特殊注册表相关函数处理的项。

参数：

szSubKey

指定先前调用 RegDBSetDefaultRoot 设置的开关键中某一个的子项。使用反斜杠来指定子项的更深层。为检索开关键，传递一个空字符串。

nItem

指定必须被放置在列表中的项目。在该参数位置传递下列预定义常量之一：

REGDB_KEYS ：在 listResult 返回的字符串列表将包含一个该项下的所有子项的列表。

REGDB_NAMES ：在 listResult 返回的字符串列表将包含该项的所有命名值的名。

listResults

返回在一个字符串列表中排队的结果。由 listResult 标识的列表必须已经通过调用 ListCreat 而被初始化。

返回值：

0 ：表明函数成功。

< 0 ：表明函数失败。

15.17 RegDBSetAppInfo

语法： RegDBSetAppInfo (szName, nType, szValue, nSize);

说明： RegDBSetAppInfo 函数设置注册表中应用程序信息项下的一个特定数值名的值。你在调用 RegDBSetAppInfo 前必须调用 InstallationInfo 来创建一个应用程序信息项。

RegDBSetAppInfo 是一个特殊的注册表相关函数，被设计来处理特定的预定义注册表项。

参数：

szName

指定其信息要被设置的数值名。

nType

指定你要设置的数据的类型，在该参数位置传递下列预定义常量之一：

请参阅 15.12 中该部分的说明。

szValue

指定为数值名设置的值。

nSize

以字节数返回传递给 RegDBSetAppInfo 的数据的大小。给该参数传递 -1 来表明 InstallShield 应该确定该数据的大小。

返回值：

0 ：表明函数成功给数值名赋值。

< 0 ：表明函数未能赋值。

15.18 RegDBSetDefaultRoot

语法： RegDBSetDefaultRoot (nRootKey);

说明： RegDBSetDefaultRoot 函数设置一个被其它注册表函数使用的开关键。大多数 InstallShield 注册表函数工作在以 HKEY_CLASSES_ROOT 为注册表树的缺省根。使用该函数，你可以指定另一个项，如 HKEY_LOCAL_MACHINE 或 HKEY_CURRENT_USER 或 HKEY_USERS 为开关键。

RegDBGetKeyValueEx 是一个通用注册表相关函数，设计为可工作于所有注册表项，包括那些由特殊注册表相关函数处理的项。

你可以使用 RegDBSetDefaultRoot 来修改使用特殊注册表相关函数创建或处理项的开关键。

参数：

nRootKey

指定设置为开关键的项的名。

返回值：

0 ：表明函数成功设置项。

< 0 ：表明函数未能设置项。

注解：

· Windows NT 4.0 不允许在 HKEY_LOCAL_MACHINE 下直接创建一个项。

15.19 RegDBSetItem

语法： RegDBSetItem (nItem, szValue);

说明： RegDBSetItem 函数给每应用程序路径项或应用程序卸载项下赋值，根据 nItem 的值而定。以 REGDB_APPPATH 或 REGDB_APPPATH_DEFAULT 选项调用 RegDBSetItem 则结果创建每应用程序路径项。注意你必须在调用 RegDBSetItem 之前调用 InstallationInfo 来创建这些项。

RegDBSetItem 是一个特殊的注册表相关函数，被设计来处理特定的预定义注册表项。

参数：

nItem

指定要设置的项目（条目）。在该参数位置传递下列预定义常量之一：

REGDB_APPPATH ：在每应用程序路径项下的 [Path] 值。

REGDB_APPPATH_DEFAULT ：在每应用程序路径项下的 [DefaultPath] 值。

REGDB_UNINSTALL_NAME ：卸载项下的 [DisplayName] 值。当使用该常量时， szValue 指定在控制面板中卸载应用程序列表中的显示的应用程序名。

szValue

指定赋给指定项目的值。

返回值：

0 ：表明函数成功设置值。

< 0 ：表明函数失败。最通常的失败原因是没有前调用 InstallationInfo 函数。该函数只有在你调用 InstallationInfo 后才能被执行。

注解：

·在使用 REGDB_APPPATH 或 REGDB_APPPATH_DEFAULT 选项（它们将影响创建每应用程序路径项，也影响在其下写一个值）调用 RegDBSetItem 函数之前，你必须调用 InstallationInfo 函数来提供被使用来创建该项的信息。

·当你调用 MaintenanceStart 或 DeinstallStart 函数时， [UninstallString] 值被创建。

15.20 RegDBSetKeyValueEx

语法： RegDBSetKeyValueEx (szKey, szName, nType, szValue, nSize);

说明： RegDBSetKeyValueEx 函数设置注册表中一个项下指定的数值名的值。如果该项不存在， RegDBSetKeyValueEx 将会为你创建它。然而，新创建的项不会存入卸载记录除非它是一个已经存入卸载记录的项的子项。如下情况项会存入卸载记录：

当它们使用 RegDBCreateKeyEx 而被创建。
当存入功能被激活时。
当它们在安装进程中由 InstallShield 自动被创建。
当它们作为调用一个特殊注册表相关函数的结果而被创建。

如果数值名不存在， RegDBSetKeyValueEx 创建它。如果数值数已经存在， RegDBSetKeyValueEx 改写它。 InstallShield 假定 szKey 中的数值名是 HKEY_CLASSES_ROOT 项的一个子项。如果你想要使用一个不同的主项，则使用 RegDBSetDefaultRoot 函数来设置该主开关键。

RegDBSetKeyValueEx 是一个通用注册表相关函数，设计为可工作于所有注册表项，包括那些由特殊注册表相关函数处理的项。

参数：

szKey

指定要设置的项的名；该项必须已经由 RegDBCreateKeyEx 创建。你不必要在该参数包括 HKEY_CLASSES_ROOT 项（或你指定的其它项）。用一个双反斜杠来分隔子项的不同层。

szName

指定要被设置的数值数的数值名。为设置在 szKey 指定的项的缺省值，给该参数传递一个空字符串。

nType

指定你要设置的数据的类型，在该参数位置传递下列预定义常量之一：

请参阅 15.12 中该部分的说明。

szValue

指定和数值名相联系的值。所有值必须以字符串变量传递。数字必须表示为字符串（ InstallShield 内部将它们转换为数字）。

nSize

以字节数指定要被设置的数据的大小。当 nType 是 REGDB_STRING, REGDB_STRING_EXPAND, 或 REGDB_NUMBER 时，你可以将该参数指定为 -1 ， InstallShield 会设置其大小。然而，当 nType 为 REGDB_BINARY 和 REGDB_STRING_MULTI 时，你必须总指定你在保存的二进制数据的字节数。

返回值：

0 ：表明函数成功设置该项。

< 0 ：表明函数未能设置该项。

15.21 SetInstallationInfo

语法： SetInstallationInfo (szCompany, szProduct, szVersion, szProductKey);

说明：在一个基于事件的脚本中， SetInstallationInfo 函数在 Begin 事件之前被自动调用，以字符串表表目 COMPANY_NAME, PRODUCT_NAME, PRODUCT_VERSION, 和 PRODUCT_KEY 为其参数。 SetInstallationInfo 指定该信息由 CreateInstallationInfo （它在一个基于事件脚本中就在 First UI Before 事件后被自动调用来创建你正在安装的程序的一个应用程序信息项和一个每应用程序路径项）使用。

SetInstallationInfo 是一个特殊注册表相关函数，设计为可工作于特定预定义的注册表项。

参数：

szCompany

指定公司名。 CreateInstallationInfo 使用 szCompany 来创建注册表中 [HKEY_LOCAL_ MACHINE]\Software 项下的\ <company> 项。

szProduct

指定被安装的产品的名称。 CreateInstallationInfo 使用 szProduct 来创建注册表中 [HKEY_LOCAL_MACHINE]\Software\<company> 项下的\ <product> 项。 SzProduct 的值也被插入到欢迎对话框中消息文本的第一段中。

szVersion

szProductKey

返回值：

该函数总返回 0 。

16 列表处理函数

列表被使用来保存相关信息组。在 InstallShield 中，有两类列表：字符串列表和数字列表。提供两组函数来处理列表：每个处理一种类型。以 "Item" 结尾的列表函数处理数字列表。以 "String" 结尾的列表函数处理字符串列表。你不能将数字列表函数使用到字符串列表，反之亦然。下面是在一个安装脚本中处理列表的函数。

ListAddItem

添加一项到一个列表。

ListAddString

添加一个字符串到一个列表。

ListCount

返回在一个指定列表中字符串或数值型元素的数目。

ListCreate

创建一个新的字符串或数字列表。

ListCurrentItem

返回一个列表中的当前项目。

ListCurrentString

返回一个列表中的当前字符串。

ListDeleteItem

删除一个列表中当前项目。

ListDeleteString

删除一个列表中的当前字符串。

ListDestroy

消除一个列表。

ListFindItem

使指定项目成为一个数字列表中的当前项目。

ListFindString

使指定项目成为一个字符串列表中的当前项目。

ListGetFirstItem

从一个数字列表中检索第一个元素。

ListGetFirstString

从一个字符串列表中检索第一个元素。

ListGetNextItem

从一个数字列表中检索当前元素后的元素。

ListGetNextString

从一个字符串列表中检索当前元素后的元素。

ListReadFromFile

读一个文本文件到一个列表。

ListSetCurrentItem

设置一个数字列表中的当前元素。

ListSetCurrentString

设置一个字符串列表中的当前元素。

ListSetIndex

使用一个索引来设置一个列表的当前元素。

ListWriteToFile

写一个字符串列表到一个文件。

16.1 ListAddItem

语法： ListAddItem (listID, nItem, nPlacementFlag);

说明： ListAddItem 函数将一个数值型元素添加到一个数字列表中当前元素的前面或后面。为遍历一个列表，首先调用 ListGetFirstItem 得到列表的第一个元素；然后重复调用 ListGetNextItem 直到你到达列表尾。为使列表中的一个特定元素成为当前元素，调用 ListSetIndex 。

参数：

listID

指定一个数字列表的名称。由 listID 标识的列表必须早已由 ListCreate 函数初始化。

nItem

指定要添加到列表中的数值型元素。

nPlacementFlag

指定在哪儿放置和当前元素相关的 nItem 。新元素可以在当前元素之前或之后。在该参数位置传递下列预定义常量之一：

AFTER ：将新元素添加到列表中当前元素之后。

BEFORE ：将新元素添加到列表中当前元素之前。

返回值：

0 ： ListAddItem 成功添加元素到一个数字列表。

< 0 ： ListAddItem 未能添加元素到一个数字列表。

注解：

· ListAddItem 仅工作于数字列表。

16.2 ListAddString

语法： ListAddString (listID, szString, nPlacementFlag);

说明： ListAddString 函数添加一个字符串到一个字符串列表中当前元素之前或之后。为遍历一个列表，首先调用 ListGetFirstItem 得到列表的第一个元素；然后重复调用 ListGetNextItem 直到你到达列表尾。为使列表中的一个具体元素成为当前元素，调用 ListSetIndex 。

参数：

listID

指定一个字符串列表的名称。由 listID 标识的列表必须早已由 ListCreate 函数初始化。

szString

指定添加到列表中的字符串。

nPlacementFlag

指定在哪儿放置和当前元素相关的 szString 。新字符串可以在当前元素之前或之后。在该参数位置传递下列预定义常量之一：

AFTER ：将新字符串添加到列表中当前元素之后。

BEFORE ：将新字符串添加到列表中当前元素之前。

返回值：

0 ： ListAddString 成功添加字符串到列表。

< 0 ： ListAddString 未能添加字符串到列表。

注解：

· ListAddString 仅工作于字符串列表。

16.3 ListCount

语法： ListCount (listID);

说明： ListCount 函数返回一个列表中的元素数目。

参数：

listID

指定一个字符串或数字列表的名称。

返回值：

>= 0 ：列表中的项目数。

< 0 ： ListCount 未能确定列表中的元素数。

注解：

·该函数工作于字符串和数字列表。

16.4 ListCreate

语法： ListCreate (nListType);

说明： ListCreate 函数创建一个空的字符串或数字列表。记住一个列表不能包括两个类型的元素。 InstallShield 提供不同的函数组来工作于字符列表和数字列表。你必须不能将一个数字列表的 ID 用于字符串列表函数，反之亦然。以 "Item" 结尾的列表函数处理数字列表。以 "String" 结尾的列表函数处理字符串列表。

当你不再需要列表时，你可以用 ListDestroy 函数来消除列表。每个列表都有一个指针来标识一个元素为列表的当前元素。不同的列表函数重新定位列表的当前元素。调用任何列表函数时，你必须给该函数传递列表的一个有效 ID 。确定该函数创建列表成功。否则，所有列表函数因无效列表而失败。

参数：

nListType

指定要创建的列表类型。在该参数位置传递下列预定义常量之一：

NUMBERLIST ：指定一个数字列表。

STRINGLIST ：指定一个字符串列表。

返回值；

ListID ：新创建的空列表的 ID 。无论何时你要在其它 InstallShield 列表函数中使用该列表，你都必须使用该 ID 。你必须检测该变量并确认函数没有返回 LIST_NULL 。

LIST_NULL (-1) ：表明 InstallShield 未能创建一个列表。那是一个严重内存问题的结果，这是很少见的一种情况。有这样的内存问题时你要继续安装可能会很困难。

注解：

·在你传递一个有效列表 ID 给任何需要一个列表的函数时，你必须使用 ListCreat 创建该列表。你可以在一个脚本中创建任意个列表。一个列表可能包含任意个元素。唯一的限制是有效空闲内存的大小。

16.5 ListCurrentItem

语法： ListCurrentItem (listID, nvItem);

说明： ListCurrentItem 函数从 listID 指定的数字列表中检索当前元素。

参数：

listID

指定一个数字列表。

nvItem

返回列表中当前元素的值。

返回值；

0 ：表明函数成功在一个数字列表中检索当前元素。

< 0 ：表明函数未能在一个数字列表中检索当前元素。

END_OF_LIST (1) ：表明列表为空因而没有一个当前元素。

注解：

·该函数仅工作于数字列表。

·你也可以使用 ListGetFirstItem 和 ListGetNextItem 函数来遍历列表并使任何元素为当前元素。

16.6 ListCurrentString

语法： ListCurrentString (listID, svString);

说明： ListCurrentString 函数从 listID 指定的字符串列表中检索当前元素。

参数：

listID

指定一个字符串列表。

svString

返回列表当前元素的值。

返回值：

0 ：表明函数成功在一个字符串列表中检索当前元素。

< 0 ：表明函数未能在一个字符串列表中检索当前元素。

END_OF_LIST (1) ：表明列表为空因而没有一个当前元素。

注解：

·该函数仅工作于字符串列表。

·你也可以使用 ListGetFirstString 和 ListGetNextString 函数来遍历列表并使任何元素为当前元素。

16.7 ListDeleteItem

语法： ListDeleteItem (listID);

说明： ListDeleteItem 函数从你在 listID 指定的数字列表中删除当前元素。

参数：

listID

指定从中删除当前元素的数字列表。

返回值：

0 ：表明函数从一个数字列表中成功删除当前元素。

< 0 ：表明函数未能从一个数字列表中删除当前元素。

END_OF_LIST (1) ：表明列表为空因而没有一个当前元素。

注解：

请参阅 ListCurrentItem 的注解。

16.8 ListDeleteString

语法： ListDeleteString (listID);

说明： ListDeleteString 函数从你在 listID 指定的字符串列表中删除当前元素。

参数：

listID

指定从中删除当前元素的字符串列表。

返回值：

0 ：表明函数从一个字符串列表中成功删除当前元素。

< 0 ：表明函数未能从一个字符串列表中删除当前元素。

END_OF_LIST (1) ：表明列表为空因而没有一个当前元素。

注解：

请参阅 ListCurrentString 的注解。

16.9 ListDestroy

语法： ListDestroy (listID);

说明： ListDestroy 函数消除一个列表的内容及列表本身。使用该函数来删除一个 listID 指定的字符串或数字列表。

参数：

listID

指定要消除的字符串或数字列表。

返回值：

0 ：表明函数成功消除列表，把它从内存中删除。

< 0 ：表明函数未能消除列表。

注解：

·该函数既可作用于字符串列表，也可作用于数字列表。一旦一消除了一个列表，不要再在任何列表函数中使用该 listID 。

·当你不再需要时或在安装脚本结尾时，消除你创建的所有列表。当你消除一个列表，你就释放了和该列表联系的所有内存。

16.10 ListFindItem

语法： ListFindItem (listID, nItem);

说明： ListFindItem 函数在一个数字列表中查找一个特定元素，从当前元素开始并从该点继续往下。如果你想从列表头开始查找，使用 ListGetFirstItem 函数。当 ListFindItem 找到元素时，它就成为列表的当前元素。

参数：

listID

指定要查找的数字列表。

nItem

指定要在列表中查找的项目。

返回值：

0 ：表明函数成功找到所要求的元素。

< 0 ：表明一个错误阻止函数查找指定列表。如，如果由 listID 指定的列表不存在则会发生错误。

END_OF_LIST (1) ：表明 InstallShield 查找到了列表结尾但没有找到所要求的元素。

注解：

·该函数仅工作于数字列表。

16.11 ListFindString

语法： ListFindString (listID, szString);

说明： ListFindString 函数在一个字符串列表中查找一个特定元素，从当前元素开始并从该点继续往下。如果你想从列表头开始查找，使用 ListGetFirstString 函数。当 ListFindString 找到元素时，它就成为列表的当前元素。

该函数对字符串比较时区分大小写。

参数：

listID

指定要查找的字符串列表。

szString

指定要在列表中查找的字符串。当查找该字符串时， InstallShield 执行一个区分大小写的比较。

返回值：

0 ：表明函数成功找到所要求的元素。

< 0 ：表明一个错误阻止函数查找指定列表。如，如果由 listID 指定的列表不存在则会发生错误。

END_OF_LIST (1) ：表明 InstallShield 查找到了列表结尾但没有找到所要求的元素。

注解：

·该函数仅工作于字符串列表。

16.12 ListGetFirstItem

语法： ListGetFirstItem (listID, nvItem);

说明： ListGetFirstItem 函数从一个数字列表中检索第一个元素。该第一个项目成为该列表中的当前元素。

参数：

listID

指定要检索其第一个元素的数字列表。

nvItem

返回数字列表的第一个元素。

返回值：

0 ：表明函数成功检索了一个数字列表的第一个元素。

-1 ：表明发生了一个错误阻止函数检索一个数字列表中的第一个元素。

END_OF_LIST (1) ：表明列表为空。

注解：

·该函数仅工作于数字列表。

16.13 ListGetFirstString

语法： ListGetFirstString (listID, svString);

说明： ListGetFirstString 函数从一个字符串列表中检索第一个元素。该第一个项目成为该列表中的当前元素。

参数：

listID

指定要检索其第一个元素的字符串列表。

svString

返回字符串列表的第一个元素。

返回值：

0 ：表明函数成功检索了一个字符串列表的第一个元素。

-1 ：表明发生了一个错误阻止函数检索一个字符串列表中的第一个元素。

END_OF_LIST (1) ：表明列表为空。

注解：

·该函数仅工作于字符串列表。

16.14 ListGetNextItem

语法： ListGetNextItem (listID, nvItem);

说明： ListGetNextItem 函数检索一个数字列表中当前元素之后的项目。被检索的项目成为该列表中的当前元素。

参数：

listID

指定要从中检索下一个元素的数字列表。

nvItem

返回在数字列表中紧随当前元素的项目。该项目成为列表中的当前元素。

返回值：

0 ：表明函数成功检索一个数字列表中当前元素之后的元素。

-1 ：表明发生一个错误阻止函数检索一个数字列表中的指定元素。

END_OF_LIST (1) ：表明当前项目是列表中的最后一个元素。

注解：

·该函数仅工作于数字列表。

16.15 ListGetNextString

语法： ListGetNextString (listID, svString);

说明： ListGetNextString 函数检索一个字符串列表中当前元素之后的项目。被检索的项目成为该列表中的当前元素。

参数：

listID

指定要从中检索下一个元素的字符串列表。

svString

返回在数字列表中紧随当前元素的项目。该项目成为列表中的当前元素。

返回值：

0 ：表明函数成功检索一个字符串列表中当前元素之后的元素。

-1 ：表明发生一个错误阻止函数检索一个字符串列表中的指定元素。

END_OF_LIST (1) ：表明当前项目是列表中的最后一个元素。

注解：

·该函数仅工作于字符串列表。

16.16 ListReadFromFile

语法： ListReadFromFile (listID, szFile);

说明： ListReadFromFile 函数读一个文本文件到一个列表。一旦你把一个文本文件装入一个列表，你就可以在安装中把它用到不同的函数，如在安装结尾显示一个 README 文件或用 ListWriteToFile 写一个字符串列表到磁盘。

该函数让你可以很方便地把整个文件装入到一个列表，而不是一次创建一个列表项。

参数：

listID

返回一个从 szFile 指定的文件中读入行的列表。由 listID 标识的列表必须已经由 ListCreat 初始化。

szFile

指定将要被读入列表的文件的全限定名。

返回值：

0 ：表明函数成功将一个文件中的文本行读入到一个列表。

< 0 ：表明函数未能将一个文件中的文本行读入到一个列表。

注解：

·该函数检测每个字符串结尾的换行符并使用这些字符作为列表中每个元素的分界符。

·该函数仅作用于字符串列表和文本文件。

16.17 ListSetCurrentItem

语法： ListSetCurrentItem (listID, nItem);

说明： ListSetCurrentItem 函数将 nItem 的值赋给一个数字列表中的当前元素。

参数：

listID

指定其当前元素要被更新的数字列表的名称。由 listID 标识的列表必须早以由 ListCreat 初始化。

nItem

指定将要置换当前元素的数值型值。

返回值：

0 ：表明函数成功更新数字列表中的当前元素。

< 0 ：表明函数未能更新数字列表中的当前元素。

END_OF_LIST (1) ：表明列表为空。

注解：

·该函数仅工作于数字列表。

16.18 ListSetCurrentString

语法： ListSetCurrentString (listID, szString);

说明： ListSetCurrentString 函数将 szString 的值赋给一个字符串列表中的当前元素。

参数：

listID

指定其当前元素要被更新的字符串列表的名称。由 listID 标识的列表必须早以由 ListCreat 初始化。

szString

指定将要置换当前元素的字符串型值。

返回值：

0 ：表明函数成功更新字符串列表中的当前元素。

< 0 ：表明函数未能更新字符串列表中的当前元素。该错误的通常的原因是下标超出有效列表元素的范围。

注解：

·该函数仅工作于字符串列表。

16.19 ListSetIndex

语法： ListSetIndex (listID, nIndex);

说明： ListSetIndex 函数使用一个下标来指定一个字符串列表或数字列表中的一个特定元素为当前元素。你也可以使用使用一个常量来一次检索列表中的一个元素或跳到列表的头或尾。通过使用下标来访问列表中的项，你可以将数字列表或字符串列表处理为队列。

下标数从 0 开始。例如，如果你在参数 nIndex 中输入 5 ，则列表中的第六个物理位置的项成为当前元素。使用 ListCurrentItem 和 ListCurrentString 来检索当前元素的值。

参数：

listID

指定其下标要被设置的字符串列表或数字列表的名称。

nIndex

指定你要设置为当前元素的元素的数。列表元素从 0 开始计数。在该参数位置传递一个数值型值或下列预定义常量之一：

LISTFIRST ：移动到列表的第一个元素。

LISTLAST ：移动到列表的最后一个元素。

LISTNEXT ：移动到列表的下一个元素。

LISTPREV ：移动到列表的前一个元素。

返回值：

0 ：表明函数成功更新列表中的当前元素。

< 0 ：表明函数未能更新列表中的当前元素。

END_OF_LIST (1) ：表明下标超出有效列表元素的范围。

注解：

·在你设置被索引的元素为当前元素后，你可以在脚本中使用 ListCurrentItem 或 ListCurrentString 函数来检索被索引（当前）项的值。

·该函数可工作于字符串列表和数字列表。

16.20 ListWriteToFile

语法： ListWriteToFile (listID, szFileName);

说明： ListWriteToFile 函数将一个字符串列表写到一个文本文件。每个字符串显示在文本文件中分隔的行中。

参数：

listID

指定写到一个文本文件中的字符串名。

szFileName

指定要写字符串列表到其中的文件的全限定名。如果文件不存在，则被创建。如果文件已经存在，则它被修改。

返回值：

0 ：函数成功。

< 0 ：函数失败。

17 外壳函数

外壳函数创建新的程序文件夹，删除存在的程序文件夹，添加项目到存在的程序文件夹。在安装的最后，添加应用程序到适当的程序文件夹以允许用户立即访问你的软件。下列函数也支持不同的图标选项。

AddFolderIcon

添加一个图标到一个文件夹。

CreateProgramFolder

创建一个程序文件夹。

CreateShellObjects

创建在资源窗格的外壳对象文件夹中指定文件夹和快捷方式（或组和图标）。

DeleteFolderIcon

从一个程序文件夹中删除一个图标或项目。

DeleteProgramFolder

从目标系统中删除一个程序文件夹。

GetFolderNameList

检索指定文件夹中的所有子文件夹名和快捷方式。

ProgDefGroupType

在 Windows NT 环境中将组标识为公用或专用。

QueryProgItem

返回有关一个指定的程序项目或子文件夹的信息。

QueryShellMgr

返回当前外壳管理程序的名称。

ReplaceFolderIcon

置换一个指定文件夹中的一个图标。

SelectFolder

呈现一个对话框，允许最终用户从一个程序文件夹列表中选择一个文件夹。

ShowProgramFolder

显示指定的程序文件夹。

17.1 AddFolderIcon

语法： AddFolderIcon (szProgramFolder, szItemName, szCommandLine, szWorkingDir,

szIconPath, nIcon, szShortCutKey, nFlag);

说明： AddFolderIcon 函数插入或置换由 szProgramFolder 指定的程序文件夹中的一个图标。如果程序文件夹不存在， AddFolderIcon 创建它。 SzProgramFolder 可以在一个多级级联式菜单中指定一个子文件夹。如果子文件夹不存在， AddFolderIcon 将创建该子文件夹，并且在必要时创建它的父文件夹。

当添加图标到 Windows NT 下的组时，首先调用 ProgDefGroupType 来确定组为公用还是专用。缺省时，文件夹图标添加为公用。

参数：

szProgramFolder

指定将图标添加至的文件夹的名称。如果该文件夹不存在， InstallShield 创建它。

为添加图标到具体的文件夹，指定全限定路径，如：

"C:\\WINDOWS\\STARTMENU\\PROGRAMS\\ACCESSORIES\\GAMES".

为添加一个快捷方式图标到 Windows 95 及更高版本的开始程序菜单，给该参数传递一个空字符串 ("") 。

注意你也可以在该参数位置传递下列 InstallShield 系统变量之一：

FOLDER_DESKTOP ：将图标添加到桌面文件夹。

FOLDER_STARTUP ：将图标添加到启动菜单文件夹。

FOLDER_STARTMENU ：将图标添加到开始菜单文件夹。

FOLDER_PROGRAMS ：将图标添加到开始菜单\程序文件夹。

你也可以指定一个相对于一个由 InstallShield 系统变量标识的文件夹的路径，例如，

FOLDER_PROGRAMS ^ "ACCESSORIES\\GAMES"

指定要添加到文件夹的图标名。该名将显示在图标下面。在 Windows 95 及更高版本下，调用 AddFolderIcon 添加一个图标到一个程序文件夹时，也在由 szCommandLine 指定的链接目录中创建一个链接文件。注意开发人员外壳不允许在项目名中有下列字符： /, \, :, ?, <, >, 或 | 。

szCommandLine

指定下列情况之一：

和图标相联系的可执行文件的全限定名，包括任何命令行参数。为添加一个快捷方式图标到 Windows 95 及更高版本的开始程序菜单，输入一个链接目录的全限定路径，在那儿你的应用程序存放了它的图标链接文件。
全限定路径，如果 szItemName 是一个子文件夹。（仅对 Windows 95 及更高版本、 Windows NT 4.0 ）。

如果命令行包含一个长文件名，它必须由引号包围（括起）。更多信息请查看下面的注解部分。

szWorkingDir

指定应用程序文件所在的目录。（如果 szItemName 是一个子文件夹则不适用）。为使得包含程序文件的目录为工作目录，给该参数传递一个空字符串 ("") 。不要调用 LongPathToQuote 来把该路径包围（括）在引号中。更多信息请查看下面的注解部分。

szIconPath

定要显示的图标的全限定文件名。（如果 szItemName 是一个子文件夹则不适用）。不要调用 LongPathToQuote 来把该路径包围（括）在引号中。更多信息请查看下面的注解部分。

nIcon

指定 Windows 中由 szIconPath 指定的可执行文件的的图标序号。（如果 szItemName 是一个子文件夹则不适用）。图标序号数从 0 开始，因此为显示可执行文件的第一个图标，指定 0 ；为显示第二个，指定 1 ，如此继续。如果你不使用一个 Windows 图标，给该参数指定 0 。

szShortCutKey

指定快捷键（以字符串形式），允许最终用户迅速启动应用程序。例如，如果你想要能通过按下 "Ctrl","Alt" 然后 "1" 键来打开应用程序，则给该参数传递 "Ctrl+Alt+1" 。如果 szItemName 是一个子文件夹则不适用）。

nFlag

指定图标表现形式。在该参数位置传递下列预定义常量之一或多个。为给该参数传递两个或更多预定义常量，用按位或操作符 (|) 将那些常量进行组合：

REPLACE ：表明文件夹中的当前图标或项目被置换。

RUN_MAXIMIZED ：表明程序被装入时必须被最大化。

RUN_MINIMIZED ：表明程序被装入时必须被最小化。

NULL ：表明没有选项。

返回值：

0 ：表明函数成功添加或置换指定文件夹中的图标并使可执行文件和图标相关联。

< 0 ：表明函数没有能添加或置换指定文件夹中的图标并使可执行文件和图标相关联。

注解：

·如果到你的应用程序可执行文件的路径包含长路径名，你必须把该全限定文件名用单引号或双引号括起来。（如果文件名已经被赋给一个变量，传递该变量给 LongPathToQuote 来插入引号。）注意命令行参数必须不被引号包围。因此，建议从两个分隔的字符串来建立一个 szCommandLine 字符串。

·不要调用 LongPathToQuote 来得到作为参数 szWorkingDir 和 szIconPath 的表达式。 InstallShield 自动将这些路径括在引号中。

17.2 CreateProgramFolder

语法： CreateProgramFolder (szFolderName);

说明： CreateProgramFolder 函数在目标系统创建一个新文件夹。如果该文件夹已经存在，它被高亮显示。在 Windows 95 及更高版本，给文件夹被创建在开始程序菜单中。当在 Windows NT 下创建程序组时，首先调用 ProgDefGroupType 来确定组为公用还是专用。缺省设置为公用。

参数：

szFolderName

指定要添加到目标系统的文件夹名。

返回值：

0 ：表明函数成功添加文件夹到目标系统或该文件夹已经存在。

< 0 ：表明该函数没有能添加指定的程序文件夹。

17.3 CreateShellObjects

语法： CreateShellObjects (szReserved);

说明： CreateShellObjects 函数创建已经在当前媒体上被指定的外壳对象（文件夹或快捷方式或组和图标）。当前媒体名被保存在系统变量 MEDIA 中。外壳对象在资源窗格的外壳对象文件夹中被定义。如果你使用一个基于事件的脚本，任何与一个或多个文件组（使用该外壳对象的文件组属性）相联系的外壳对象在那些文件组被装入时被自动创建。

注意： CreateShellObjects 不会在目标系统上创建一个空文件夹（或组）。如果资源窗格中的一个文件夹或组是空的，它将不会由安装程序创建。同样，如果为资源窗格中的一个文件夹指定的快捷方式在运行时没有被创建（因为它们相联系的文件组没有被装入），那么该文件夹不被创建。为创建一个空文件夹（或组），在你的脚本中调用 CreateProgramFolder 。

参数：

szReserved

给该参数传递一个空字符串 ("") 。不允许其它值。

返回值：

0 ：表明函数成功。

-1 ：未知错误。

-2 ：在当前媒体上，调用 ComponentTransferData 函数前调用该函数。注意，在一个运行基于事件的脚本的安装中， ComponentTransferData 被自动调用。

-3 ：文本替换失败。

-4 ：创建快捷方式失败。

-5 ：创建文件夹失败。

-6 ：创建一个 Internet 快捷方式失败。

注解：

·安装初始化过程中，系统变量 MEDIA 的值被设置为' DATA '。如果你修改该变量的值来指向一个脚本创建组件集，则你在调用 CreateShellObjects 前必须该值修改回' DATA '。

This function should be called only after ComponentTransferData has been called.

该函数只有在已经调用 ComponentTransferData 后才能被调用。

17.4 DeleteFolderIcon

语法： DeleteFolderIcon (szProgramFolder, szItemName);

说明： DeleteFolderIcon 函数从一个文件夹删除一个程序图标。

参数：

szProgramFolder

指定包含要删除图标的文件夹名。

szItemName

指定要被删除的图标名。

返回值：

0 ：表明函数成功删除指定图标。

< 0 ：表明函数没有能删除指定图标。

17.5 DeleteProgramFolder

语法： DeleteProgramFolder (szFolderName);

说明： DeleteProgramFolder 函数删除一个程序文件夹和它的内容，包括所有位于指定文件夹下的文件夹。它不能删除"程序"文件夹。

参数：

szFolderName

指定要删除的文件夹名。

返回值：

0 ：表明函数成功删除指定文件夹。

< 0 ：表明函数没有能删除指定文件夹。

17.6 GetFolderNameList

语法： GetFolderNameList (szFolderName, listItemsID, listSubFoldersID);

说明： GetFolderNameList 函数被使用来列举一个指定文件夹的所有程序项快捷方式和子文件夹。该函数也可以被用来列举一个根文件夹的所有程序项快捷方式和子文件夹。

参数：

szFolderName

指定被查询的文件夹名。你可以给 szFolderName 指定一个全限定路径，如： "C:\\Windows\\Start Menu\\Programs\\Accessories\\Games" 。如果 szFolderName 是空， GetFolderNameList 查找缺省程序目录（看下面）。如果你不给 szFolderName 指定一个绝对路径， GetFolderNameList 在缺省程序目录下查找一个子文件夹，按照操作系统：

Windows 95 及更高版本：开始菜单\程序文件夹位于 Windows 文件夹下。注意即使用户配置文件被激活，该定位不会改变。
Windows NT 4.0 （如果由 ProgDefGroupType 选定为公用）： ..\profiles\All Users\Start Menu\Programs 文件夹位于 Windows 文件夹下。
Windows NT 4.0 （如果由 ProgDefGroupType 选定为专用）： . .\profiles\<user name>\Start Menu\Programs 位于 Windows 文件夹下； <user name> 是当前用户的用户名。
你也可以使用一个 InstallShield 系统变量：

FOLDER_DESKTOP ：查找桌面文件夹。

FOLDER_STARTUP ：查找启动菜单文件夹。

FOLDER_STARTMENU ：查找开始菜单文件夹。

FOLDER_PROGRAMS ：查找开始菜单\程序文件夹。

或你可以使用一个相对路径，如：

FOLDER_PROGRAMS ^ "ACCESSORIES\\GAMES"

listItemsID

在 szFolderName 返回一个程序项快捷方式名的列表。注意在 Windows NT ，如果 szFolderName 包含专用和公用程序项，在该参数返回的列表将包含公用或专用程序项快捷方式，但不是都包含。由 listItemsID 标识的列表必须已经通过调用 ListCreat 被初始化。

listSubFoldersID

在 szFolderName 返回子文件夹名的列表。注意在 Windows NT ，如果 szFolderName 包含专用和公用程序项，在该参数返回的列表将包含公用或专用程序项快捷方式，但不是都包含。由 listSubFoldersID 标识的列表必须已经通过调用 ListCreat 被初始化。

返回值：

0 ： GetFolderNameList 成功检索所有程序项和子文件夹名。

< 0 ： GetFolderNameList 没有能检索所有程序项和子文件夹名。

注解：

·当该函数被使用在一个运行于 Windows NT 4.0 下的安装中，应用下列约束条件：

如果你列举一个具体的程序文件夹（也就是，你已经指定到达文件夹的路径），该文件夹必须与当前文件夹类型匹配，公用或专用。如果该文件夹和当前文件夹类型不匹配，它将不会被定位并且函数失败。为改变缺省文件夹类型，调用 ProgDefGroupType 。

·如果你列举一个支持专用和公用项目和文件夹的文件夹，如 FOLDER_PROGRAMS ，只有那些适当类型的程序项快捷方式和文件夹将由该函数返回。为改变缺省文件夹类型，调用 ProgDefGroupType 。

17.7 ProgDefGroupType

语法： ProgDefGroupType (nType);

说明： ProgDefGroupType 函数将指定一个程序组在 Windows NT 下为专用或公用。在你调用 AddFolderIcon 或 CreateProgramFolder 前调用该函数。缺省程序组类型是公用。

　　该函数仅使用在 Windows NT 环境中。它在其它环境中被忽略。

参数：

nType

指定一个程序组类型。在该参数位置传递下列预定义常量之一：

PERSONAL ：指定一个专用程序组。

COMMON ：指定一个公用程序组。

返回值：

0 ：函数通常返回 0 。

注解：

·如果一个运行在 Windows NT 下的安装中调用 SdSelectFolder 前调用了 ProgDefGroupType ， SdSelectFolder 将根据传递给 ProgDefGroupType 的参数显示程序文件夹（公用或专用）。

17.8 QueryProgItem

语法： QueryProgItem (szFolderName, szItemName, svCmdLine, svWrkDir, svIconPath,

nvIconIndex, svShortCutKey, nvMinimizeFlag);

说明： QueryProgItem 函数检验一个指定程序项或子文件夹名是否存在。如果 InstallShield 找到该项目或子文件夹， QueryProgItem 返回它的属性。属性包括应用程序的命令行，工作目录，图标路径，快捷键和最小化标志。

为使用 QueryProgItem ，在参数 szFolderName 和 szItemName 位置输入信息。 InstallShield 将用程序项的属性来填充剩余的参数。

当在 Windows NT 下查询组或文件夹时，首先调用 ProgDefGroupType 来确定组为公用还是专用。缺省设置为公用。

参数：

szFolderName

指定包含该项目或子文件夹的文件夹名。你可以给 szFolderName 指定一个全限定路径，如：

"C:\\WINDOWS\\START MENU\\PROGRAMS\\ACCESSORIES\\GAMES"

如果 szFolderName 是空， QueryProgItem 查找缺省程序目录（看下面）。如果你不给 szFolderName 指定一个绝对路径， QueryProgItem 在缺省程序目录下查找一个子文件夹，按照操作系统：

Windows 95 及更高版本：环境变量 Windir 下的开始菜单\程序。
Windows NT 4.0 （如果由 ProgDefGroupType 选定为公用）：环境变量 Windir 下的 ..\profiles\All Users\Start Menu\Programs 目录。
Windows NT 4.0 （如果由 ProgDefGroupType 选定为专用）：环境变量 Windir 下的 . .\profiles\<user name>\Start Menu\Programs 目录； <user name> 是从系统变量 USERPROFILE 得的当前用户的用户名。
你也可以使用一个 InstallShield 系统变量：

FOLDER_DESKTOP ：在桌面文件夹中查询项目。

FOLDER_STARTUP ：在启动菜单文件夹中查询项目。

FOLDER_STARTMENU ：在开始菜单文件夹中查询项目。

FOLDER_PROGRAMS ：在开始菜单\程序文件夹中查询项目。或者你可以使用一个相对路径，例如：

FOLDER_PROGRAMS ^ "ACCESSORIES\\GAMES"

szItemName

指定要找的程序项或子文件夹名。

svCmdLine

返回项目的可执行文件的命令行或子文件夹的完全路径。

svWrkDir

返回程序项工作目录的全路径。（如果 szItemName 是一个子文件夹则不适用。）

svIconPath

返回 .ico 文件或 .exe 文件的全限定文件名。（如果 szItemName 是一个子文件夹则不适用。）

nvIconIndex

返回作为程序项图标的索引。（如果 szItemName 是一个子文件夹则不适用。）

svShortCutKey

返回项目的快捷键。（如果 szItemName 是一个子文件夹则不适用。）

nvMinimizeFlag

（如果 szItemName 是一个子文件夹则不适用。）返回下列常量之一，指示第一次显示时一个应用程序窗口是否被最小化：

NULL ：表明应用程序窗口启动时不被最小化。

RUN_MINIMIZED ：表明应用程序窗口启动时被最小化。

返回值：

IS_ITEM (0) ：表明 szItemName 是 szFolderName 的一个程序项或快捷方式。

IS_FOLDER (1) ：表明 szItemName 是 szFolderName 的一个子文件夹。

< 0 ：表明该函数不能找到程序项或子文件夹名。

注解：

·不同语言下开始菜单位置不同。不管如何， InstallShield 能自动选择正确路径。

17.9 QueryShellMgr

语法： QueryShellMgr (svShellMgrName);

说明： QueryShellMgr 函数得到 Microsoft Windows 使用的程序外壳名。如，如果程序外壳是 Explorer ，则 QueryShellMgr 在参数 svShellMgrName 返回字符串 "Explorer.exe" 。

如果目标系统的外壳不是 Explorer ，你可能需要用 LaunchApp 函数来装入该外壳。创建程序文件夹和程序图标的 InstallShield 函数与外壳使用一个 DDE 会话来创建程序文件夹和程序项。大多数可选外壳如 Norton Desktop 仿真 Explorer 外壳。因此，它们可以创建程序文件夹和项目。

在不仿真 Explorer 外壳的外壳中， InstallShield 不能使用程序文件夹和程序项函数来创建或修改程序文件夹和程序项。

参数：

svShellMgrName

返回当前运行的外壳管理程序的非限定名（也就是，没有驱动器标识或路径）。

返回值：

0 ：表明函数成功检索程序外壳名。

< 0 ：表明函数没有能检索程序外壳名。

17.10 ReplaceFolderIcon

语法： ReplaceFolderIcon (szProgramFolder, szItemName, szNewItem, szCmdLine,

szWorkingDir, szIconPath, nIcon, szShortCutKey, nFlag);

说明： ReplaceFolderIcon 函数置换一个指定文件夹中的一个图标。你必须指定一个存在的文件夹，可以是一个你用 CreateProgramFolder 函数创建也可以是一个已经存在于用户系统上的。

参数：

szProgramFolder

指定包含要被置换的图标的文件夹名。

szItemName

指定要置换的图标名。

szNewItem

指定置换后要显示的图标名。

szCmdLine

指定下列之一：

和图标相联系的可执行文件的全限定名，包括任何命令行参数。
如果 szItemName 是一个子文件夹，则是全限定路径。

szWorkingDir

指定应用程序文件所在的目录。（如果 szItemName 是一个子文件夹则不适用）。为是包含程序文件的目录为工作目录，给该参数传递一个空字符串 ("") 。

szIconPath

指定包含该新图标的一个图标文件名或一个有效的 Windows 可执行文件。

nIcon

如果你指定一个 Windows 可执行图标，则指定该图标序号。否则，给该参数传递 0 。

szShortCutKey

指定包含快捷键序列的字符串，用户可以按下它们来启动应用程序。例如，如果你想要能通过按下 "Ctrl","Alt" 然后 "1" 键来打开应用程序，则给该参数传递 "Ctrl+Alt+1" 。如果 szItemName 是一个子文件夹则不适用）。

nFlag

指定一个或多个选项。在该参数位置传递下列预定义常量。为给该参数传递多个选项，用按位或操作符 (|) 将那些常量进行组合：

NULL ：表明没有选项。

REPLACE ：表明存在的图标要被新图标置换。

RUN_MAXIMIZED ：表明程序被装入时要最大化。

RUN_MINIMIZED ：表明程序被装入时要最小化。

返回值：

0 ：表明成功置换图标。

< 0 ：表明函数没有能置换图标。

17.11 SelectFolder

语法： SelectFolder (szTitle, szDefFolder, svResultFolder);

说明： SelectFolder 函数显示一个对话框，允许最终用户在一个编辑区输入一个程序文件夹名或从一个列表中选择一个程序文件夹。该函数自动显示系统中的所有程序文件夹。一个传递给 svDefFolder 的缺省的文件夹名被显示在编辑区。被选定的文件夹名在 svResultFolder 返回。如果指定文件夹不存在，它不会被创建。

参数：

szTitle

指定对话框标题。为显示缺省标题 ( "选择程序文件夹" ) ，给该参数传递一个空字符串 ("") 。

szDefFolder

指定要显示为缺省文件夹的文件夹名。

svResultFolder

返回有最终用户选定或指定的文件夹名。如果该文件夹不存在，你必须调用 CreateProgramFolder 来创建它； SelectFolder 不会创建该文件夹。

返回值：

NEXT (1) ：表明最终用户选定 Next 按钮。

BACK (12) ：表明最终用户选定 Back 按钮。

< 0 ：表明函数成功。

17.12 ShowProgramFolder

语法： ShowProgramFolder (szFolder, nCommand);

说明： ShowProgramFolder 函数显示一个程序文件夹。

参数：

szFolder

指定要显示的文件夹名。

nCommand

指定文件夹状态。在该参数位置传递下列预定义常量之一：

SW_SHOW ：以标准状态显示文件夹。

SW_MAXIMIZE ：最大化文件夹。

SW_MINIMIZE ：最小化文件夹。

SW_RESTORE ：将文件夹还原到原始大小。

返回值：

该函数没有返回值。

18 扩展函数

　　扩展函数允许你调用动态链接库中的函数，调用 Windows APIs ，或运行另一个应用程序或安装程序脚本。 UseDLL 和 UnUseDLL 函数允许你装入一个 DLL 到内存中或卸载它并使用 DLL 。 LaunchApp 和 LaunchAppAndWait 函数允许你仍在执行脚本时运行另一个 Windows 或 DOS 应用程序。

CallDLLFx

从一个外部 DLL 中调用函数。

Delay

延迟安装程序脚本的执行。

LaunchApp

运行另一个程序。

LaunchAppAndWait

运行另一个程序并等待该程序终止。

UnUseDLL

从内存卸载一个 DLL 。

UseDLL

把一个 DLL 装入到内存。

18.1 CallDLLFx

语法： CallDLLFx (szDLL, szFunction, lvValue, svValue);

说明： CallDLLFx 函数调用一个指定的 DLL 中的函数。该函数必须使用下列固定定义， hwnd 是 InstallShield 主窗口的主窗口句柄：

LONG APIENTRY YourFunction (HWND hwnd, LPLONG lpIValue, LPSTR lpszValue);

参数：

szDLL

指定包含要执行的函数的 DLL 的全限定文件名。

szFunction

指定由 szDLL 指定的 DLL 中的函数的名称。

IvValue

指定访问一个 DLL 函数时传递的长整型变量。

svValue

指定传递给 DLL 函数的字符串变量。

返回值：

CallDLLFx 函数从 DLL 中的函数返回一个长整型数。

18.2 Delay

语法： Delay (nSeconds);

说明： Delay 函数使一个安装程序脚本的执行延迟一个指定的秒数。其它和 InstallShield 同时运行的任务在 InstallShield 被延迟时仍正常进行。

参数：

nSeconds

指定程序被延迟的秒数。

返回值：

0 ：表明函数成功延迟了脚本的执行。

< 0 ：表明函数未能延迟了脚本的执行。

18.3 LaunchApp

语法： LaunchApp (szCommand, szCmdLine);

说明： LaunchApp 函数允许你在脚本内运行另一个应用程序。该应用程序和脚本同时运行。 InstallShield 对运行的应用程序没有控制权并且不能确定运行的应用程序是否成功运行。运行的应用程序和其它在运行 InstallShield 时你启动的应用程序一样运行。你可以在 InstallShield 中运行任何你可以在操作系统中正常运行的应用程序。

参数：

szCommand

指定要运行的应用程序的全限定名。如果你指定一个没有路径的文件名， InstallShield 在当前文件夹中， Windows 文件夹中， Windows 系统文件夹中和列在环境变量 PATH 中的文件夹中查找。

如果应用程序的全限定名包括长文件夹名和 / 或一个长文件名，在把 szCommand 传递给 LaunchAppAndWait 之前先把它传递给 LongPathToQuote 。

szCmdLine

指定传递给 szCommand 标识的应用程序的命令行参数（如果有）。如果没有参数，则迟到一个空字符串。

返回值：

0 ： LaunchApp 成功运行应用程序。

< 0 ： LaunchApp 未能找到或未能运行应用程序。

注解：

·安装进程在应用程序被运行后继续。应用程序即使在安装脚本终止后仍可以运行。

·你也可以使用 FindWindow 和 SendMessage 函数来控制或发送消息给运行的应用程序。如果你想要在一个 Window 中运行一个 DOS 应用程序，你可以提供一个和 DOS 应用程序同名的 PIF （ Program Information File ）。在 PIF 文件中，你指定应用程序运行在其下的一个窗口方式。

·运行一个 DOS 程序时，你不能确定返回结果 DOS_ERRORLEVEL 。然而你可以把一个 DOS 应用程序放进一个批处理文件，让批处理文件来识别错误并创建另一个包含返回错误代码的文件。然后你可以读该文件并确定从 DOS 应用程序返回的错误代码。

· LaunchApp 使用 Windows API 的 CreateProcess 来运行应用程序。

18.4 LaunchAppAndWait

语法： LaunchAppAndWait (szProgram, szCmdLine, lWait);

说明： LaunchAppAndWait 函数运行由 szProgram 指定的带有 szCmdLine 指定的命令行参数的应用程序。第三个参数， lWait 指示安装在继续前是否要等待直到运行的应用程序终止。

　　一个安装程序只能监控由 szProgram 指定的应用程序；如果该应用程序要运行其它应用程序或进程，安装程序不能监控它们。因此，安装程序将在第一个应用程序结束后继续，即使那时由第一个应用程序运行的其它应用程序仍在运行。注意如果运行的应用程序终止失败，则安装程序将无限等待运行的应用程序完成。

参数：

szProgram

指定要被运行的应用程序的文件名。建议要指定应用程序的完整路径和文件名。如果你不包括一个路径， InstallShield 将使用被 Windows API 函数 CreateProcess 使用的相同的查找次序来定位文件。如果文件未能在这些位置找到，函数将失败。

　　如果应用程序的全限定名包括长文件夹名和 / 或一个长文件名，在把 szCommand 传递给 LaunchAppAndWait 之前先把它传递给 LongPathToQuote 。

szCmdLine

指定传递给运行的应用程序的命令行参数。为运行没有命令行参数的应用程序，传递一个空字符串。

lWait

指定安装程序在继续前是否要等待运行的应用程序终止。在该参数位置传递下列预定义常量之一：

NOWAIT ：指定安装程序在运行应用程序后立即继续，应用程序将和安装程序脚本同时运行。注意使用该参数等效于调用函数 LaunchApp 。

WAIT ：指定安装程序必须等待直到由该函数运行的应用程序终止。

返回值：

1 ：表明应用程序成功运行。

< 0 ：表明应用程序未能运行。

注解：

· InstallShield 安装程序使用函数 CreateProcess 。在 InstallShield 运行应用程序后，它查找装入的应用程序的窗口句柄。如果它找到窗口句柄，则它在继续前等待直到应用程序窗口消失。

·安装程序不能监控一个不创建窗口的应用程序。如果指定的应用程序没有创建一个窗口，安装程序在运行应用程序后立即继续。注意应用程序的窗口不需要可见，但它必须存在，以便让安装程序等待。

·一些应用程序试图装入 DLLs 并且当那些 DLLs 不能被定位时不能正确运行。为确保一个应用程序能找到它需要的 DLLs ，有必要在调用 LaunchAppAndWait 前改变到包含可执行应用程序的目录。为改变当前目录，调用 ChangeDirectory 函数。

· 如果运行的应用程序终止失败，则安装程序将无限等待运行的应用程序完成。

· LaunchAppAndWait 以一个全屏 DOS 窗口来运行 DOS 程序。为以一个不同类型的窗口来运行一个 DOS 程序，你必须直接调用 Windows APIs 。

18.5 UnUseDLL

语法： UnUseDLL (szDLLName);

说明： UnUseDLL 函数从内存卸载一个 DLL 。 UnUseDLL 将该 DLL 的锁计数减少一。当锁计数等于 0 时， InstallShield 卸载该 DLL 。每一个对 UseDLL 的调用都必须有一个对应的对 UnUseDLL 的调用，因而 DLLs 在它们不再需要时不会留在内存中而浪费系统资源。一旦你卸载了一个 DLL ，你不能再调用该 DLL 中的函数。

Microsoft Windows 系统 DLLs, 如 User.exe, User32.dll, Gdi.exe, Gdi32.dll, Krnl386.exe, Krnl286.exe, 和 Kernel32.dll ，自动由 Windows 装入和卸载。不要调用 UseDLL 和 UnUseDLL 来装入和卸载这些 DLLs 。

参数：

szDLLName

指定 DLL 的文件名。该参数不要包含路径。

返回值：

0 ：表明函数成功解锁和从内存卸载 DLL 。

< 0 ：表明函数未能解锁和卸载 DLL 。

注解：

如果脚本在用 UnUseDLL 正确卸载 DLL 前退出或终止， DLL 将被锁定在内存。如果你试图再次访问 DLL ，你的脚本可能失败。你必须通过重启 Windows 来将 DLL 从内存中删除。

18.6 UseDLL

语法： UseDLL (szDLLName);

说明： UseDLL 函数把一个 DLL 装入内存。在 DLL 已经被装入内存后，你的安装程序脚本可以调用该 DLL 中的函数。注意如果由 szDLLName 指定的 DLL 需要其它 DLL ，那些 DLL 必须位于某个文件夹中，该 DLL 试图从这个文件夹装入它们。正常时它是当前目录。为确保那些 DLL 可以被定位，在调用 UseDLL 前调用 ChangeDirectory 来改变当前目录到那些 DLL 所处的位置。若不能做到这些，则可能 DLL 不能被正确装入。

　　每次你将一个 DLL 装入到内存，该 DLL 的锁计数增加。锁计数计算使用该 DLL 的应用程序的数目。你不再使用 DLL 时，你必须马上调用 UnUseDLL 来卸载它。如果你不卸载不再需要的 DLL ，则该 DLL 在没有应用程序需要它时仍会留在内存中，因而浪费系统资源。在脚本中每个对 UseDLL 的调用必须有一个相对应的 UnUseDLL 调用。

参数：

szDLLName

指定要装入的 DLL 名。如果你未指定一个扩展名， InstallShield 假定文件扩展名为 .dll 或 .exe 。建议该参数包括一个路径，但只是可选。如果该参数没有指定 DLL 的路径， InstallShield 将使用和 Windows API 函数 LoadLibrary 使用的相同的查找次序来查找 DLL 。

有关查找次序的更多信息可查看 Windows API 函数的说明。

为在你的安装中包含 DLL ，把它添加到安装文件窗格中的 Language Independent 文件夹的合适的子文件夹中。 InstallShield 将把它压缩到你的安装中。当 Setup.exe 执行时，它自动解压缩并把你的安装的内容拷贝到由 SUPPORTDIR 指定的临时目录中。然后你可以添加 DLL 文件名到 SUPPROTDIR 以便指向该 DLL ，如下所示：

szDLLName = SUPPORTDIR^"MYDLL.DLL";

UseDLL (szDLLName);

如果你不放置你的 DLL 到你的安装中（通过把它插入到安装文件窗格中的合适文件夹中），你可以把文件和你的应用程序文件一起分散，然后从目标系统装入它。然而，如果你这么做，你必须指定你把 DLL 安装到的位置使得你的安装程序可以指向它。你也必须确保你的安装程序不会试图在 DLL 被传输到目标系统之前装入它。

返回值：

0 ：表明函数成功地把 DLL 装入内存。

< 0 ：表明函数未能把 DLL 装入内存。

注解：

·如果 UseDLL 失败，最大的可能性是 DLL 没有找到。如果这样，确保参数 szDLLName 指定了正确的路径。

·另一个通常的使用 DLL 的错误原因和 DLL 的依赖性有关：被你装入的 DLL 所访问的 DLLs 。如果你的 DLL 访问的 DLLs 没有被装入或没有找到，你的 DLL 调用可能失败。如果发生这种情况，确保其它 DLL 存在于系统上并且它们是可访问的。

·如果脚本在用 UnUseDLL 正确卸载 DLL 前退出或终止， DLL 将被锁定在内存。如果你试图再次访问 DLL ，脚本可能失败。你必须通过重启 Windows 来将 DLL 从内存中删除。

19 批处理函数

19.1 高级批处理文件函数

高级批处理文件函数和 Ez 批处理文件函数不同，它们提供更大的灵活性和对批处理文件的更多控制。当需要对一个批处理文件做更多扩充和更复杂的修改，则使用这些函数。

为用这些高级函数来编辑一个批处理文件，你必须首先通过调用 BatchFileLoad 把该文件装入到内存。当完成了对该批处理文件的修改，然后必须调用 BatchFileSave 保存该文件。

安装初始化时，它选择目标系统的启动批处理文件（ Autoexec.bat) 作为缺省批处理文件（除非通过调用 BatchSetFileName 来修改），如果没有指定其它文件名，该文件就是由 BatchFileLoad 读入内存的文件。为确定缺省批处理文件的全限定名，调用 BatchGetFileName 。

不要把 Ez 配置文件函数和高级配置文件函数混合起来。调用 BatchFileLoad 之后，直到你调用了 BatchFileSave 保存你的修改后，你才能使用 Ez 配置文件函数。

BatchAdd

添加一个环境变量到一个批处理文件。

BatchDeleteEx

删除批处理文件中的一行。

BatchFileLoad

把一个批处理文件装入内存来用高级批处理函数编辑它。

BatchFileSave

保存一个由 BatchFileLoad 装入的批处理文件。

BatchFind

在一个批处理文件中查找项目。

BatchGetFileName

检索缺省批处理文件的全限定名。

BatchMoveEx

移动一个批处理文件中的一个项目。

BatchSetFileName

指定作为缺省批处理文件的一个批处理文件。