Opens an existing ZIP archive, in preparation of extracting items (files) from it. The archive may be on disk, or in memory, or be spooled from an open pipe.
Synopsis
error = UnzipOpen(VariableName, Location, Option, Password)
Args
VariableName is the name of some variable where you would like an UNZIP handle (to this particular archive) stored. This handle will need to be passed to other RxUnzip functions. If you're passing the variable name directly, remember to quote it.
Location depends upon the value of Option.
Option is one of the following:
Option Meaning 'FILE' The ZIP archive exists on disk. Location is the full pathname of the ZIP archive. 'MEMORY' The ZIP archive is loaded into memory. Location is the ZIP archive passed directly to UnzipOpen. 'PIPE' The ZIP archive is to be spooled from a pipe, or read from an already open file. Location is the handle of the pipe/file. 'RESOURCE' The ZIP archive is in the resources of the executable. Location is the resource number.
If omitted, Option defaults to "FILE".
If you want password decryption, then Password your password string. Otherwise, omit this arg for no decryption.
Returns
An empty string if the ZIP archive is successfully opened, or an error message if not. (If ZipErr is set to "NUM", then 0 is returned for success, or an error number).
Notes
After you're finished with the ZIP archive, you must pass the UNZIP handle to UnzipClose.