Sorry. I wasn’t trying to offer a critique as much as seeking guidance. The message doesn’t mean anything specific to me. It seems like I get different errors for values that exceed the bounds or objects that don’t exist or can’t be set.
What should I interpret this error message to mean? “General failure”?
It isn’t a general error. You were getting DEVICE_SYNTAX which we decode into “Syntax error in command or file”. We have some other info we wrap around that.
Here is a collection Typed errors and associated strings.
NOERR: “No Error.”
DEVICE_ERROR: “Error class < device error >”
DEVICE_SRVNOTSUPP: “Service is not supported”
DEVICE_INVALIDCMD: “Invalid index”
DEVICE_INVALIDINDEX: “Invalid offset”
DEVICE_INVALIDACCESS: “Reading/Writing not permitted”
DEVICE_INVALIDSIZE: “Parameter size not correct”
DEVICE_INVALIDDATA: “Invalid parameter value(s)”
DEVICE_NOTREADY: “Device is not in a ready state”
DEVICE_BUSY: “Device is busy”
DEVICE_INVALIDCONTEXT: “Invalid context”
DEVICE_NOMEMORY: “Out of memory”
DEVICE_INVALIDPARM: “Invalid parameter value(s)”
DEVICE_NOTFOUND: “Not found (files, …)”
DEVICE_SYNTAX: “Syntax error in command or file”
DEVICE_INVALIDSTATE: “Device is in invalid state”
DEVICE_NOMOREHDLS: “No more handles”
DEVICE_TIMEOUT: “Device has a timeout”
DEVICE_OPENFAILED: “Device open failed”
DEVICE_SENDFAILED: “Device send failed”
DEVICE_INSERTMAILBOX: “Device Insert Mailbox error.”
DEVICE_INVALIDOFFSET: “Invalid subindex”
DEVICE_UNKNOWNMAILBOXCMD: “Unknown Mailbox Command”
DEVICE_ACCESSDENIED: “Device access denied”
DEVICE_INVALIDARRAYIDX: “Device Invalid array idx”
DEVICE_EXISTS: “Device Exists Error”
DEVICE_INVALIDADDR: “Device Invalid Address”
DEVICE_INCOMPATIBLE: “Device Incompatible”
DEVICE_ABORTED: “Request aborted”
DEVICE_PENDING: “Request aborted, Device pending”
DEVICE_PARAM_ACCESS_ERROR: “Unknown error occurred while accessing parameter”
DEVICE_PARAM_NOT_FOUND: “Parameter was not found”
DEVICE_PARAM_NOT_INTEGER: “Parameter is an floating-point value”
DEVICE_VALUE_IS_NEGATIVE: “No negative values allowed”
DEVICE_VALUE_OUT_OF_RANGE: “Value is out of data-range”
DEVICE_VALUE_GREATER_THAN_MAX: “Value bigger than maximum”
DEVICE_VALUE_LOWER_THAN_MIN: “Value lower than minimum”
CLIENT_ERROR: “Client Error”
CLIENT_TIMEOUT: “Client Timeout”
CLIENT_INVALIDPARM: “Client Invalid Parameter”
CLIENT_INVALIDSIZE: “Client Invalid Size”
CLIENT_INTERNAL: “Client Internal error or ASCII channel command too long”
None of the above: “Error Not Found.”