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 %NATDIR%\%NATVERS%\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. |
