The interface functions return the following return codes. The constants are defined in the header file natni.h. This file is contained in the directory <install-dir>/natural/samples/sysexnni.
Return Code | Meaning |
---|---|
NNI_RC_OK
|
Successful execution. |
NNI_RC_ILL_PNUM
|
Invalid parameter number. |
NNI_RC_INT_ERROR
|
Internal error. |
NNI_RC_DATA_TRUNC
|
Data has been truncated during parameter value access. |
NNI_RC_NOT_ARRAY
|
Parameter is not an array. |
NNI_RC_WRT_PROT
|
Parameter is write protected. |
NNI_RC_NO_MEMORY
|
Memory allocation failed. |
NNI_RC_BAD_FORMAT
|
Invalid Natural data type. |
NNI_RC_BAD_LENGTH
|
Invalid length or precision. |
NNI_RC_BAD_DIM
|
Invalid dimension count. |
NNI_RC_BAD_BOUNDS
|
Invalid x-array bound definition. |
NNI_RC_NOT_RESIZABLE
|
Array cannot be resized in the requested way. |
NNI_RC_BAD_INDEX_0
|
Index for array dimension 0 out of range. |
NNI_RC_BAD_INDEX_1
|
Index for array dimension 1 out of range. |
NNI_RC_BAD_INDEX_2
|
Index for array dimension 2 out of range. |
NNI_RC_VERSION_ERROR
|
Requested interface version not supported. |
NNI_RC_NOT_INIT
|
No Natural session initialized in this interface instance. |
NNI_RC_NOT_IMPL
|
Function not implemented in this interface version. |
NNI_RC_PARM_ERROR
|
Mandatory parameter not specified. |
NNI_RC_LOCKED
|
Interface instance is locked by another thread. |
rc, where rc < NNI_RC_SERR_OFFSET
|
Natural startup error occurred. The Natural startup error number as documented
in Natural Startup Errors (which is part of the
Operations documentation) can be determined from the return
code by the following calculation:
startup-error-nr =
- (rc - |
> 0 | Natural error number. |