int __stdcall zOpenZipFile(char *zipfilename);
This function opens zip file and creates a list of
items, corresponding to contents of zip file. Must be called before any
other function to get access to zip file. ZipFileName is the path
and full name of zip file, for example: 'C:\TEST.ZIP'. Returns zero on
success.
int __stdcall zCloseZipFile(void);
Closes zip file, opened with zOpenZipFile.
Returns zero on success.
int __stdcall zGetTotalFiles(void);
Returns the total number of compressed files within
zip file, i.e. the number of items in the list. First item has index =
0, last item has index = zGetTotalFiles-1
int __stdcall zGetTotalBytes(void);
Returns the sum of uncompressed file size of all
files within zip file.
int __stdcall zGetSelectedFiles(void);
Returns the number of currently selected files.
int __stdcall zGetSelectedBytes(void);
Returns the sum of uncompressed file size of selected
files within zip file.
char * __stdcall zGetLastErrorAsText(void);
If some error occurs in the DLL, this function will
return the string, describing the error.
int __stdcall zGetSkipedFiles(void);
After extracting operation, this function will return
the number of skipped files - usually zero.
bool __stdcall zGetRunTimeInfo(int &ProcessedFiles,int
&ProcessedBytes);
This function returns the number of currently processed
files and bytes. This is necessary to calculate position of progress indicator.
Returns true on success.
bool __stdcall zCancelOperation(void);
To cancel extract operation, call this function.
int __stdcall zExtractOne(int ItemNo,char *ExtractDirectory,char
*Password,
bool OverwriteExisting,bool UseFolders,bool
TestOnly,void (__stdcall *RTInfoFunc)(void));
Extracts only one of the file in zip file. This is
useful for viewing/launching files. Parameters are:
ItemNo - Item number of the file in the
list.
0<= ItemNo <= zGetTotalFile-1
ExtractDirectory - Directory where to extract files. If empty, current directory is used.
Password - password to be used, if file is encrypted.
OverwriteExisting - if true, any existing file will be overwritten, otherwise will be skipped.
UseFolders - if true, the relative path information stored in zip file will be used to determine location of the extracting file.
TestOnly - if true, files are only tested, not saved to disk.
RTInfoFunc - pointer to the application function, which will be called periodically from library to show runtime information, for example some kind of progress bar. Within this function, application can call zGetRunTimeInfo or zCancelOperation. If nil, no runtime information will be available.
Return value is zero on success, otherwise application
can call zGetLastErrorAsText to get type of error.
int __stdcall zExtractSelected(char *ExtractDirectory,char
*Password,
bool OverwriteExisting,bool UseFolders,bool
TestOnly,void (__stdcall *RTInfoFunc)(void));
Extracts only files in the list, previously selected
by zSelectFile. Parameters are the same as in zExtractOne.
Returns zero on success.
int __stdcall zExtractAll(char *ExtractDirectory,char
*Password,
bool OverwriteExisting,bool UseFolders,bool
TestOnly,void (__stdcall *RTInfoFunc)(void));
Extracts all files. Parameters are the same as in
zExtractOne. Returns zero on success.
char * __stdcall zGetFileName(int i);
Returns the name of the file in the list with index
i.
char * __stdcall zGetFileExt(int i);
Returns the extension of the file in the list with
index i.
char * __stdcall zGetFilePath(int i);
Returns the stored path of the file in the list with
index i.
int __stdcall zGetFileDate(int i);
Returns the MSDOS date of the file in the list with
index i.
int __stdcall zGetFileTime(int i);
Returns the MSDOS time of the file in the list with
index i.
int __stdcall zGetFileSize(int i);
Returns the uncompressed size of the file in the
list with index i.
int __stdcall zGetCompressedFileSize(int i);
Returns the compressed size of the file in the list
with index i.
bool __stdcall zFileIsEncrypted(int i);
Returns true, if file in the list with index i is
encrypted.
char * __stdcall zGetLastOperResult(int i);
Returns the result of the last operation on the file
in the list with index i. Usually 'Ok.'
bool __stdcall zFileIsSelected(int i);
Returns true, if file in the list with index i is
selected.
bool __stdcall zSelectFile(int i,bool how);
Select/Unselect file in the list with index i. If
how is true, the file will be selected, otherwise will be unselected.
(c) TopSpeedSoft, 1998