09 InstallShield内部库函数全集九-文件和文件夹函数(中文版)(2)

Installshield相关函数

则它不会在卸载记录中找到。

9.6 DeleteDir

语法：DeleteDir(szDir, nFlag);

说明：DeleteDir函数删除一个子目录。根据你在参数nFlag使用的值，你可以仅当子目录为空时删除它，即使子目录包含文件也删除它，或删除整个根目录。设置nFlag需特别谨慎。 参数：

szDir

指定要被删除的目录的全限定名。

nFlag

指定删除选项。在该参数位置传递下列预定义常量之一：

ALLCONTENTS：删除szDir指定的目录，包括其下的所有子目录和文件。你删除的目录必须是一个子目录，不能是驱动器上的一个根目录。

ONLYDIR：仅当szDir指定的目录为空时才删除它。否则函数失败。

ROOT：即使szDir指定的目录是根目录也要删除它。如果szDir是一个根目录，DeleteDir将删除磁盘上一切东西。

返回值：

0：表明函数成功删除子目录。

< 0：表明函数未能删除子目录。

注解：

·你不能删除当前目录。

·你不能删除一个网络系统上你没有适当权利的文件。

·DeleteDir不能删除只读，隐藏或系统文件。

·如果DeleteDir遇到一个只读文件，该函数可能在只删除子目录中一些文件后失败。

9.7 DeleteFile

Installshield相关函数

语法：DeleteFile (szFile);

说明：DeleteFile函数删除一个或多个文件。注意DeleteFile不能删除只读，隐藏或系统文件。如果你试图删除一个网络系统上你没有适当文件权利的文件时，该函数不起作用。 参数：

szFile

指定要删除文件的名称。如果szFile指定一个全限定名，也就是，包括一个路径，DeleteFile将从指定目录删除该文件。如果szFile包含一个未限定文件名，也就是，没有路径信息，DeleteFile将从由系统变量TARGETDIR指定的目录中删除文件。可以在szFile中包含通配符来删除多个文件。

返回值：

0：表明函数成功删除指定文件。

< 0：表明函数未能删除指定文件。

注解：

你在使用FindFile时可以使用通配符来定位文件然后用DeleteFile删除它们。

9.8 ExistsDir

语法：ExistsDir (szPath);

说明：ExistsDir函数在目标系统上检测指定目录的存在性。

参数：

szPath

指定要在目标系统上找到的目录的全限定路径。

返回值：

EXISTS (0)：表明指定目录存在于目标系统上。

NOTEXISTS (-1)：表明指定目录不存在于目标系统上。

9.9 ExistsDisk

Installshield相关函数

语法：ExistsDisk (szDisk);

说明：ExistsDisk函数在目标系统上检测指定磁盘驱动器的存在性。

参数：

szDisk

指定磁盘驱动器字符。

返回值：

EXISTS (0)：表明目标系统上存在指定驱动器。

NOTEXISTS (-1)：表明目标系统上不存在指定驱动器。

9.10 FileCompare

语法：FileCompare (szFileName1, szFileName2, nCompareFlag);

说明：FileCompare函数比较两个文件的大小，日期或版本。

参数：

szFileName1

指定要比较的第一个文件的全限定名。

szFileName2

指定要比较的第二个文件的全限定名。

nCompareFlag

指定比较选项。在该参数位置传递下列预定义常量之一：

COMPARE_SIZE：比较两个文件的大小。

COMPARE_DATE：比较两个文件的日期。

COMPARE_VERSION：比较两个文件的版本资源。

返回值：

EQUALS (2)：第一个文件的日期，大小或版本和第二个的相等。

FILE_NOT_FOUND (-2)：函数未能找到一个文件或都未能找到。

Installshield相关函数

GREATER_THAN (0)：第一个文件比第二个文件更新或更大，根据在参数nCompareFlag使用的常量：

．COMPARE_VERSION

文件一比文件二新。

．COMPARE_DATE

文件一比文件二日期后。

．COMPARE_SIZE

文件一比文件二大。

．LESS_THAN (1)

文件一比文件二旧或小。

OTHER_FAILURE (-1)

发生不确定错误。

9.11 FileDeleteLine

语法：FileDeleteLine (szFileName, nStartLineNum, nEndLineNum);

说明：FileDeleteLine函数从一个文本文件中使用一个起始行和结束行行号来删除该区域的行（包括起始行和结束行）。该函数作用于面向行的文本文件；它不作用于二进制文件。你可以使用FileDeleteLine 和FileGrep函数来查找和删除一个文件中的文本行。

由szFileName指定的文件必须尚未通过调用OpenFile被打开。如果szFileName已经被打开，在调用FileDeleteLine前调用CloseFile。

参数：

szFileName

指定文件的全限定名，它位于系统变量SRCDIR指定的目录中。如果该文件存在，由nStartLineNum 和nEndLineNum指定的行将从该文件中删除。

nStartLineNum

Installshield相关函数

指定要从文件中删除的第一行的行号。注意行从0开始编号。

nEndLineNum

指定要从文件中删除的最后一行的行号。注意行从0开始编号。为了从nStartLineNum指定的行开始删除到文件结尾，给该参数传递预定义常量DELETE_EOF。

返回值：

0：FileDeleteLine从该文件成功删除指定行。

< 0：FileDeleteLine因为下列情况之一而失败：

FILE_NOT_FOUND (-2)：InstallShield未能找到szFileName指定的文件。

FILE_RD_ONLY (-5)：文件是写保护的。

LINE_NUMBER (-7)：一个你所指定的行号小于0，或者文件中没有该行号。

OUT_OF_DISK_SPACE (-6)：没有足够的磁盘驱动器空间来完成指定操作。

OTHER_FAILURE (-1)：发生其它一些不确定错误。

9.12 FileGrep

语法：FileGrep (szFileName, szSearchStr, svReturnLine, nvLineNumber, nFlag);

说明：FileGrep函数在一个文本文件中查找一个指定字符串。如果字符串被找到，包含该字符串的行被返回到参数svReturnLine，该行的行号被返回到参数nvLineNumber。查找不区分大小写。FileGrep作用于面向行的文本文件；它不作用于二进制文件。

在用FileGrep查找一个文件之前没有必要打开它；你也无须在调用FileGrep之后关闭它。文件打开和文件关闭由FileGrep自动执行。虽然多数情况下，FileGrep对一个已经被打开的文件（先前调用OpenFile的结果）将成功执行，但如果文件是以添加方式打开时，FileGrep将返回FILE_NOT_FOUND。

参数：

szFileName

指定要查找的文件的全限定名。

Installshield相关函数

szSearchStr

指定查找字符串。

svReturnLine

返回szSearchStr被找到的行。

nvLineNumber

返回szSearchStr被找到的行的行号。行以0开始编号。

nFlag

指定查找选项。在该参数位置传递下列预定义常量之一：

CONTINUE：检索查找字符串的下一个出现（如果有）。

RESTART：检索查找字符串的第一次出现。

返回值：

0：FileGrep找到指定字符串。

< 0：FileGrep因下列情况之一而失败：

END_OF_FILE (-4)：没有找到查找字符串而已到文件尾。

FILE_NOT_FOUND (-2)：InstallShield未能找到szFileName指定的文件。

FILE_LINE_LENGTH (-3) …… 此处隐藏：3041字，全部文档内容请下载后查看。喜欢就下载吧 ……