LZCopy功能将源文件复制到目标文件。如果使用Microsoft文件压缩实用程序(COMPRESS.EXE)压缩源文件,则此函数将创建一个解压缩的目标文件。如果源文件未压缩,则此函数将复制原始文件。
LONG LZCopy(
INT 【hfSource】, | // LZ文件句柄识别源文件 |
INT 【hfDest】 | // LZ文件句柄识别目标文件 |
); |
参数
【hfSource】
标识源文件。
【hfDest】
标识目标文件。
返回值
如果函数成功,则返回值指定目标文件的大小(以字节为单位)。
如果函数失败,则返回值为LZERROR_ *代码。这些代码的值小于零。请注意,LZCopy既不调用SetLastError也不调用SetLastErrorEx;因此,它的失败不会影响线程的最后一个错误代码。
以下是LZCopy失败后可以返回的LZERROR_ *代码的列表:
值 | 含义 |
LZERROR_BADINHANDLE | 标识源文件的句柄无效。该文件无法读取。 |
LZERROR_BADOUTHANDLE | 标识目标文件的句柄无效。该文件无法写入。 |
LZERROR_GLOBALLOC | 已经超过打开的压缩文件的最大数量,或者无法分配本地内存。 |
LZERROR_GLOBLOCK | LZ文件句柄无法锁定。 |
LZERROR_READ | 源文件格式无效。 |
备注
必须通过调用LZInit或LZOpenFile功能检索识别源文件和目标文件的句柄。
用于复制文件的首选功能是LZCopy.提供CopyLZFile功能,以兼容16位版本的Windows。
如果功能成功,则由【hfDest】参数标识的文件始终未压缩。
也可以看看