Most of the SafeHouse utilities support scripting and automation from the command line. When running these utilities from the command line or from some other programming environment. they will set the Win32 process exit code upon termination. This is a standard convention for Windows programming. The exit code can subsequently be obtained by calling the GetExitCodeProcess() Windows function.
These same exit codes can also be obtained by using the SafeHouse ActiveX component which is intended to make it easy to run the SafeHouse executables using languages such as Visual Basic and javascript.
Please note that this information is intended only for experienced programmers who are attempting to develop some extreme scripting involving SafeHouse.
The table below identifies the exit and error codes that can be returned from the various SafeHouse executables.
|
Code |
Identifier |
Description |
|
0 |
ERR_SUCCESS |
Success. No error. |
|
1 |
ERR_FAILED |
Failed. |
|
2 |
ERR_CANCELLED |
Cancelled. Operation cancelled by user. |
|
4 |
ERR_UNKNOWN |
Unknown error. Something unexpected where none of the other codes apply. |
|
5 |
ERR_INTERNAL |
Internal error. Unexpected error that is likely a programming bug. |
|
6 |
ERR_INVALID_ERROR |
Invalid error code. |
|
7 |
ERR_BAD_PARAM |
Bad function parameter. Invalid parameter sent to an internal function. |
|
20 |
ERR_DISK |
Disk error. You may be out of disk space or you may not be able to read or write this file or folder. Used for a variety of read/write/create disk errors. |
|
21 |
ERR_DISK_4GIG |
Disk error. This volume size might be too large for this host drive. |
|
50 |
ERR_GRACE_DAYS_LEFT |
Your password has expired. You have N days left to change it. |
|
100 |
ERR_INIT_FAILURE |
Initialization failure. Some program module failed to correctly initialize. |
|
101 |
ERR_OUT_OF_MEMORY |
Out of memory. |
|
102 |
ERR_SAFEDISK_NOT_INSTALLED |
The SafeHouse device driver is not installed. Try restarting your PC. Driver is required and not present. |
|
103 |
ERR_SAFEDISK_BAD_VERSION |
The SafeHouse device driver is not the right version. |
|
104 |
ERR_SAFEDISK_CALL_FAILED |
Communication with SafeHouse device driver failed. |
|
106 |
ERR_DRIVER_BAD_PARAM |
Invalid parameter in call to SafeHouse driver. |
|
110 |
ERR_HOST_MISSING |
Volume filename missing. |
|
111 |
ERR_HOST_FILENAME_BAD |
Volume filename formatted incorrectly. |
|
112 |
ERR_HOST_RECURSIVE |
Volume cannot reside on the same drive letter as itself. |
|
113 |
ERR_HOST_FILE_NOT_FOUND |
Volume file not found. |
|
114 |
ERR_HOST_CANNOT_OPEN |
Cannot open volume file, you may need to close it first or it may not be at the specified location. This operation may not be performed on an open volume. If the volume is already open, please close it and try again. |
|
115 |
ERR_HOST_CANNOT_WRITE |
Cannot write to volume file. |
|
116 |
ERR_HOST_NOT_SAFEDISK |
Volume is not a SafeHouse volume file. |
|
117 |
ERR_HOST_IN_USE |
The volume is already open. |
|
118 |
ERR_HOST_WRONG_VERSION |
Volume is an incompatible version. |
|
119 |
ERR_HOST_ENCRYPT_UNKNOWN |
Volume uses an unsupported encryption algorithm. |
|
120 |
ERR_HOST_NOT_COMPATIBLE |
Volume file resides on an incompatible drive. |
|
121 |
ERR_HOST_DAMAGED |
Volume file has been damaged and cannot be opened. |
|
122 |
ERR_COULDNT_LOCK_FILE |
Unable to lock volume file for opening it. Couldn't lock the volume file (SHARE violation). |
|
123 |
ERR_COULDNT_LOCK_HOST |
Unable to lock host drive for opening volume. Couldn't lock the file structure on the host drive (Win 95 volume locking). |
|
124 |
ERR_COULDNT_LOCK_TARGET |
Unable to lock SafeHouse drive for mapping. Couldn't get a formatting lock on the SafeHouse drive (Win 95 volume locking). |
|
125 |
ERR_HOST_ACCESS_DENIED |
Insufficient permission for requested volume operation. |
|
126 |
ERR_HOST_CANNOT_CREATE |
Cannot create new volume file. Check the name and host folder. |
|
127 |
ERR_HOST_HEADER_FULL |
Cannot perform requested volume operation because header is full. |
|
128 |
ERR_HOST_TOO_FRAGMENTED |
Volume file is too fragmented. Defragment the host drive. |
|
129 |
ERR_HOST_READONLY |
Cannot open volume file. It may be marked read-only or in a write-protected folder. |
|
130 |
ERR_DRIVE_MISSING |
Target drive missing. Open or close volume drive field is missing. |
|
131 |
ERR_DRIVE_NOT_MAPPED |
Target drive is not a SafeHouse drive. |
|
132 |
ERR_DRIVE_IN_USE |
Target drive is already in use. |
|
133 |
ERR_ALL_DRIVES_USED |
No drive is available for use by SafeHouse. |
|
134 |
ERR_FILES_OPEN |
There are files open on the SafeHouse drive. You must close all files and Explorer windows before closing this volume. |
|
135 |
ERR_WRONG_VM |
Cannot close drive - drives must be opened and closed in the same VM. |
|
136 |
ERR_CANT_MOUNT |
Cannot open SafeHouse volume. Call to associate the volume with a drive letter failed. |
|
137 |
ERR_CANT_UNMOUNT |
Cannot close SafeHouse volume. Call to disassociate the volume and drive letter failed. |
|
138 |
ERR_VOLUME_NOT_MAPPED |
Volume is not currently open. |
|
139 |
ERR_CANT_CREATE_DEVICE |
Unable to create device for opening volume. |
|
140 |
ERR_PASSWORD_MISSING |
Password missing. |
|
141 |
ERR_PASSWORD_INVALID |
Password is invalid length or contains invalid characters. |
|
142 |
ERR_PASSWORD_WRONG |
Incorrect SafeHouse volume password. |
|
143 |
ERR_PASSWORD_EXPIRED |
Password has expired, please change it before opening this host file. |
|
144 |
ERR_PASSWORD_MISMATCH |
Verify password does not match original. |
|
145 |
ERR_PASSWORD_NOT_DIFFERENT |
New password is not different from the original. |
|
170 |
ERR_FILENAME_MISSING |
Filename is missing. Create volume filename missing. |
|
171 |
ERR_FILE_EXISTS |
File already exists. Create volume filename already exists. |
|
172 |
ERR_SIZE_MISSING |
Size is missing. |
|
173 |
ERR_SIZE_TOO_LARGE |
Size is too large. Not enough space to create file. |
|
174 |
ERR_SIZE_FS_LIMIT |
Size is larger than supported by the file system. |
|
175 |
ERR_SIZE_TOO_SMALL |
Size is too small, or expand limit is too large. |
|
176 |
ERR_SIZE_EXCEEDS_EXPAND_LIMIT |
Size exceeds expand limit. |
|
190 |
ERR_EXPAND_INVALID_SIZE |
Invalid size for drive expansion. |
|
192 |
ERR_HOST_NOT_FAT_INSIDE |
Volume has been reformatted to NTFS can therefore cannot be resized. |
|
200 |
ERR_HOST_REAL_MODE_MAPPED |
Volume file resides on a drive using real-mode mapping. This is not supported. |
|
201 |
ERR_SECURITY_VIOLATION |
Unable to use volume file (security failure). |
|
202 |
ERR_DRIVER_LOCKED |
SafeHouse driver is locked. |
|
203 |
ERR_W9X_DRIVER_OPEN_FAILURE |
Unable to open volume file in SafeHouse driver. Some network shares do not allow access from drivers. Some older versions of Windows do not allow drivers to use files over 2047 megabytes. |