JXFS Service exceptions

The standard JXFS exception is JxfsException, and contains the following parameters:
Table 1. JXFS Service exceptions
Parameter Type Meaning
errorCode int One of the defined JXFS error code constants.
errorCode Extended int An extended error code. This can be a system error code or a device-dependent error code.
description String Textual description of the error.
originException Exception The original exception that was caught and replaced by this JxfsException. For example, a RemoteException is caught and a new JxfsException with id JXFS_E_REMOTE is created. The original exception is stored and may be retrieved from here.

The following is a list of the JXFS error code constants used with the JXFSException class. Each JXFS device may have other specific error codes which are referenced in the corresponding functions.

Table 2. JXFS error code constants
Exception Code Constant Description
JXFS_E_UNREGISTERED Device Control unusable because no service connected.
JXFS_E_CLOSED Device still closed, function not yet available.
JXFS_E_OPEN Device already opened or still opened.
JXFS_E_CLAIMED Device is not claimed.
JXFS_E_NOSERVICE Requested service not available.
JXFS_E_NOTREMOTE Requested communication object is not available: that is, the device is not remotely accessible.
JXFS_E_NOCONTROL Requested Control not available.
JXFS_E_DISABLED Device is disabled.
JXFS_E_ILLEGAL Illegal request. Not allowed at this time or never allowed.
JXFS_E_NOHARDWARE The device hardware could not be found or is not connected.
JXFS_E_OFFLINE The device is switched offline.
JXFS_E_NOEXIST The requested item (device or key) does not exist.
JXFS_E_EXISTS Object already exists.
JXFS_E_FAILURE The operation failed.
JXFS_E_TIMEOUT A timeout occurred before completion.
JXFS_E_BUSY Operation not possible, device is already busy.
JXFS_E_PARAMETER_ INVALID One of the parameters given was invalid. Further information may be found in extendedErrorCode.
JXFS_E_REMOTE Errors occurred during a remote operation.
JXFS_E_IO Errors occurred during an input or output operation
JXFS_E_CANCELLED The operation was canceled by the application via cancel().
JXFS_E_NOT_SUPPORTED The operation is not supported by this object.
JXFS_E_FIRMWARE Error occurred during firmware update or no runable firmware found in the device.
JXFS_E_FIRMWARE Error occurred during firmware update or no runable firmware found in the device.
JXFS_E_SYSTEM Internal system error occurred.