The library uses well defined error codes to remain language agnostic. C does not support exceptions. Additional error data can be retrieved when they occur to provide textual error messages and optionally debug data from the plug-in or the array itself. It is the library callers responsibility to retrieve this additional information after an error occurs and before issuing another command. If additional error data exists and other functions are called the additional error information will be lost.
For computer languages that do support exceptions, a custom exception class which contains the error code and additional information is provided.
As a plug-in writer, please try to match the correct error to the situation at hand. If this is not possible return a generic error code with a meaningful text and/or additional information.