This will decrypt a whole file using the given password. This function can only decrypt files encrypted with function EncryptFile() of this library. As it may also happen, that a file is encrypted multiple times, you may do additional calls to this function until DES56_WARN_NOTCRYPTED is returned. In alternative use the function IsCryptedFile() for this purpose.
SYNTAX:
error% = DecryptFile% (file$, pass$)
INPUTS:
file$ (STRING)
- Any existing file, with full path if required. An empty file$ or not existing file results into error DES56_ERROR_NOACCESS.
pass$ (STRING)
- Any password as literal or variable. An empty password will result into error DES56_ERROR_NOPASS.
RESULT:
error% (INTEGER)
- Zero on success, else any error defined in file des56.bi.
- See also page Common Info.