SafeHouse Exit Codes

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.

 

password protect  Compare to BitLocker  lock folder  software security