The LZCopy function copies a source file to a destination file. If the source file is compressed with the Microsoft File Compression Utility (COMPRESS.EXE), this function creates a decompressed destination file.
Declare Function LZCopy Lib "lz32.dll" Alias "LZCopy" (ByVal hfSource As Long, ByVal hfDest As Long) As Long
|Operating Systems Supported|
|Requires Windows NT 3.1 or later; Requires Windows 95 or later|
Identifies the source file.
Identifies the destination file.
|If the function succeeds, the return value specifies the size, in bytes, of the destination file. |
If the function fails, the return value is an LZERROR_* code. These codes have values less than zero. Note that LZCopy calls neither SetLastError nor SetLastErrorEx; thus, its failure does not affect a threadís last-error code.
Here is a list of the LZERROR_* codes that LZCopy can return upon failure:
The handle identifying the source file is not valid. The file cannot be read.
The handle identifying the destination file is not valid. The file cannot be written.
The maximum number of open compressed files has been exceeded or local memory cannot be allocated.
The LZ file handle cannot be locked down.
The source file format is not valid.