|
the software that grows
with you
| |
|
V32Extract()
|
| Uncompresses the given files with or
without password in a from an archive in .ZIP file format. |
|
Syntax
|
| V32UnZipFile( <cFileToUnzip>,
<cPathToUnZip>, <cPassword>, <lProgressBar>,
<lWantInfo>, <aFilesToExtract> ) |
|
Arguments
|
| cFileToUnzip |
A qualified file name with drive, path and extension
information to restore the archieve. If <cFileToUnzip> does
not exist or it does not contain any file(s) for the purpose, the
operation will fail and will return with {0,0,0} array. |
| cPathToUnZip |
A fully qualified path name with drive specification
where archive is to be restored. It must not contain trailing '\'
backslash. If any files from the archive will already exist on the
destination path, those will be overwritten. |
| cPassword |
Optioanal password string of any length. Default is
null string. If <cPassword> is used to restore the archive, the
same password string would have been used with V32ZipFiles()
function. |
| lProgressBar |
Optional parameter to switch on the progress bar.
Default is FALSE. If switched on, while archive is being restore, a
progress bar will be displayed and file name currently being
processed will appear in the title bar of the progress bar
window. ( This feature is disabled for
the current release and is always FALSE ) |
| lWantInfo |
Optional parameter to instruct whether this function
should return the information gathered from archive just restored as
an array ( see below ). If <lWantInfo> is TRUE, control will
not be returned to the application until action is completed. If
<lWantInfo> is FALSE, control returns immediately after
calling this function and archive will be processed independently in
the background. ( This feature is disabled
for the current release and is always FALSE ) |
| aFileToExtract |
A one dimentional array containing file names with
extension but without drive and path information, which are to be
extracted selectively from an old archive. |
|
|
Returns
|
| NIL |
|
Description
|
| V32Extrac() is a utility to extract
indivisul files from a previous archives. User can be offered
inhouse solution to backup his critical data through a menu option and
also the feature to restore it. It
eliminates the neccessity of any external utility to do so. |
|
Usage
|
local cFileToUnzip := 'c:\application\backup\Backup1.zip'
local cPathToUnzip := 'c:\application\data'
local cPassword := ''
local aFilesToExtract := { 'config.sys','autoexec.bat' }
V32Extract( cFileToUnzip, cPathToUnzip, cPassword, lProgress, lWantInfo,
aFilesToExtract ) |
|
Tips
|
| Maintain a log book of backups with
returned information from this function and compare it somehow whenever
restoring the backups becomes neccessity. To get detailed information
about the archive, use V32ZipInfo() function. |
|