InstallShield内部库函数全集（中文版） 二
InstallShield内部库函数全集（中文版） 二
|
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 返回主安装窗口的句柄。 Is 提供文件和路径检查服务，查找一个数学协处理器，检测 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的共享版本安装于网络且有可被许多用户共享的公用文件。 |