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

Installshield相关函数

InstallShield内部库函数全集九－文件和文件夹函数（中文版）

9 文件和文件夹函数

文件和文件夹函数提供一个全面的方法来处理文本文件，二进制文件和文件夹。许多函数使用变量TARGETDIR 和SRCDIR作为路径并只接受文件名作为参数。适当时也接受通配符。

ChangeDirectory

使指定的目录为当前目录。

CloseFile

关闭一个打开的文件。

CopyFile

将一个文件从一个文件夹拷贝到另一个。

CreateDir

创建一个新文件夹。

CreateFile

创建一个指定文件名的文件。

DeleteDir

删除一个文件夹。

DeleteFile

删除一个文件。

ExistsDir

确定指定目录是否存在。

ExistsDisk

确定指定磁盘是否存在。

Installshield相关函数

FileCompare

将一个文件和另一个比较。

FileDeleteLine

删除一个文本文件中的一行。

FileGrep

在一个文本文件中查找指定文本。

FileInsertLine

在一个文本文件中插入一行。

FindAllDirs

查找指定文件夹下的所有子文件夹。

FindAllFiles

查找指定文件夹中的所有和一个文件说明匹配的文件和它的子文件夹。

FindFile

查找在指定文件夹中和一个文件说明匹配的第一个文件。

GetFileInfo

检索一个文件的属性，日期，时间和大小。

GetLine

从一个打开的文件中检索一行文本。

OpenFile

打开一现存文件。

OpenFileMode

用OpenFile函数设置文件打开的方式。

ReadBytes

从一个二进制文件中读取指定的字节数。

Installshield相关函数

RenameFile

更名一个文件。

SeekBytes

在一个二进制文件中定位文件指针。

SetFileInfo

设置一个文件的属性，日期和时间。

WriteBytes

在一个二进制文件的当前文件指针位置写入指定数目的字节。

WriteLine

将一个字符串写入一个文本文件。

XCopyFile

将一个或多个文件从一个源文件夹拷贝到一个目标文件夹，如果指定则包括子文件夹。 相关函数

SelectDir

请参阅4.10。

9.1 ChangeDirectory

语法：ChangeDirectory (szPath);

说明：ChangeDirectory函数设置当前目录。

参数：

szPath

指定要被设置为当前目录的目录名。该名可以是一个全限定路径名或一个UNC路径；它必须不包括一个尾随反斜杠。如有必要，在调用ChangeDirectory前调用StrRemoveLastSlash。 返回值：

0：ChangeDirectory成功设置指定目录为当前目录。

Installshield相关函数

< 0：ChangeDirectory未能设置指定目录为当前目录。

注解：

·注意在你调用ChangeDirectory将一个指定目录设为当前目录后，该目录不能被删除。在你可以删除该目录前，你必须再次调用ChangeDirectory来设置一个不同的当前目录。

9.2 CloseFile

语法：CloseFile (nvFileHandle);

说明：CloseFile函数关闭一个已经由调用OpenFile打开的文件。在你关闭一个文件后，你不能从中读或写到该文件。

参数：

nvFileHandle

指定要关闭的文件的句柄。

返回值：

0：表明该函数成功关闭该文件。

< 0：表明该函数未能关闭该文件。

9.3 CopyFile

语法：CopyFile (szSrcFile, szTargetFile);

说明：CopyFile函数创建一个由参数szSrcFile指定的文件的拷贝。新文件由参数szTargetFile指定文件名。

参数：

szSrcFile

指定要拷贝的文件的文件名。如果该文件名是限定的，也就是，如果它包括一个路径，

CopyFile将从指定位置拷贝该文件。如果szSrcFile包含一个未限定文件名，也就是，没有路径信息，CopyFile将从由系统变量SRCDIR标识的路径拷贝。为拷贝一组文件，在该参数位置使用通配符。

Installshield相关函数

szTargetFile

指定给由szSrcFile标识的文件的拷贝的名称。如果文件名是限定的，也就是，如果它包含一个路径，CopyFile将把文件拷贝到路径指定的位置。如果szSrcFile包含一个未限定文件名，也就是，没有路径信息，拷贝将被创建在由系统变量TARGETDIR指定的目录中。如果目标目录不存在，它将被创建。

当由szSrcFile指定的文件名中包含一个通配符时，szTargetFile的文件名部分被忽略；每个源文件以它的现存名被拷贝到由szTargetFile指定的路径。如果szTargetFile包含一个未限定文件名，文件将被拷贝到由系统变量TARGETDIR指定的目录中。因此，CopyFile不能被用来拷贝和重命名一组文件。当szSrcFile包含一个或多个通配符时，源目录和目标目录必须不同。

返回值：

0：表明函数成功地从源目录拷贝文件至目标目录。

< 0：表明函数因下列情况之一未能拷贝所要文件：

COPY_ERR_CREATEDIR (-27)：目标目录不能被创建。确保系统变量TARGETDIR中的路径语法正确并且你有权访问目标驱动器。

COPY_ERR_MEMORY (-6)：函数未能分配完成拷贝文件进程所需的内存。尽可能多地终止正在运行的应用程序以释放内存。

COPY_ERR_NODISKSPACE (-38)：函数未能在目标驱动器上找到足够的磁盘空间来拷贝文件。在目标驱动器上释放磁盘空间。

COPY_ERR_OPENINPUT (-2)：函数未能打开系统变量SRCDIR指定的输入文件。确保源文件有一个有效的文件名并且源文件和目标目录都存在。

COPY_ERR_OPENOUTPUT (-3)：函数未能拷贝所要文件。

COPY_ERR_TARGETREADONLY (-46)：TARGETDIR中的文件是只读文件。删除目标文件的只读属性并重试。

Installshield相关函数

所有其它负值：表明发生一些其它不确定错误。

注解：

·如果你使用未限定文件名并在使用CopyFile时设置SRCDIR和 TARGETDIR的值，在调用CopyFile前用VarSave保存当前值并然后用VarRestore重新设置。如果目标目录不存在，CopyFile创建它。

·你不能通过调用CopyFile时使用通配符来重命名一组文件。然而，单独一个文件时你可以使用CopyFile来做到。

·为包括子目录，调用XcopyFile函数。

·对于文件传输，XCopyFile 是CopyFile的一个完美替换。XCopyFile可以做版本检测，标记锁定的.dll和.exe文件待系统重启后更新，并且递增共享的.dll和.exe文件的注册表访问计数器。

·因为Windows 95及更高版本不允许一个空文件被拷贝，Windows NT不允许创建空文件，CopyFile在这些平台下当被用来拷贝空文件（Size=0KB）时将不工作。

· 在用WriteProfString 或 WriteProfInt修改.ini文件后， Windows 95及更高版本下，你必须在使用CopyFile前刷新高速缓存。所有.ini文件在Windows 95及更高版本下被放在高速缓存中；这种特性可能导致延迟将修改写到指定文件。这接着可能妨碍随后的文件操作。为避免这个问题，简单地以空参数调用WriteProfString来强制Windows 95 及更高版本立即写数据到.ini文件，如下所示：

WriteProfString ("C:\\Test.ini", "Windows", "KeyboardDelay", "100");

file://null string ("") for all …… 此处隐藏：8486字，全部文档内容请下载后查看。喜欢就下载吧 ……