# Enum KERNELV_RETURN

## Description

Return values and error codes of API functions.

Symbol | Value | Meaning
RET_FINISHED | 0 | The function was executed without error.
RET_BUSY | 1 | The function is currently being executed, but has not yet been completed. The API function must continue to be called.
ERR_INVALID_CHAN | -1 | The transferred channel index is higher than the number of configured channels -1.
ERR_PROG_NAME_LENGTH | -2 | The transferred program name is longer than permitted.
ERR_CNC_NOT_INIT | -3 | The simulation CNC kernel was not yet initialised.
ERR_CNC_RET_MEMORY | -4 | The return value(s) does/do not fit into the memory provided.
ERR_INVALID_STATE | -5 | The CNC channel is in the wrong state for executing a function.
ERR_DOUBLE_KERNEL | -6 | An instance of the simulation CNC is running and uses the same instance prefix. This may occur if 2 instances of kernelv were started with the function call kernelv_startup() or the same instance prefix was used several times when kernelv_startup_instance() was called.
ERR_SHM_STARTUP | -7 | Internally used shared memories could not be created when starting.
ERR_STARTUP | -8 | An error occurred on starting the simulation CNC. Possible causes are missing parameter lists or incorrect entries in parameter lists.
ERR_INVALID_AX | -9 | The transferred axis index is higher than the number of configured axes -1
ERR_AXIS_ERROR | -10 | The CNC axis indicates an error. The CNC additionally issues an error message.
ERR_INTERNAL_ERROR | -11 | An internal error has occurred in the DLL.
ERR_UNKNOWN_VARIABLE | -12 | The variable name is not known in the CNC kernel.
ERR_VARIABLE_SYNTAX | -13 | The variable name is syntactically incorrect, e.g. no closing bracket in the case of an array variable.
ERR_DATA_TYPE_MISMATCH | -14 | On write access to a variable, the transferred data type does not match the data type used internally in the CNC.

Symbol | Value | Meaning
ERR_UNKNOWN_TECHNO_TYPE | -15 | An invalid type was specified for a technology function when its execution time was set.
ERR_INVALID_TECHNO_PARAM | -16 | An invalid parameter was transferred when the execution time was set for a technology function, e.g. transferred number of the M or H function is higher than the maximum permitted number.
ERR_NO_LICENSE | -17 | No license was found for the use of the kernelv DLL.
ERR_VAR_NAME_LENGTH | -18 | The variable name passed on to the function exceeds the maximum permissible length (KERNELV_VAR_NAME_LENGTH).
ERR_REGISTRY_ACCESS | -19 | An error occurred when an attempt was made to read values from the Windows registry.
ERR_UNKNOWN_OPTION | -20 | An unknown option was transferred to the function kernelv_set_options().
ERR_ARRAY_NOT_SUPPORTED | -21 | With many CNC real-time variants, an array can be read or written ‘en block’ by omitting the array index at access. The kernelv DLL does not currently support this access type.
ERR_VAR_NOT_WRITEABLE | -22 | An attempt was made to write a non-writeable variant. For write access to variables, the same access rules apply as within an NC program. The only exception here are V.E. variables. They can always be written irrespective of the access rights configured.
ERR_PREFIX_TOO_LONG | -23 | When the function kernelv_startu_prefix() was called, the transferred instance identifier is too long with the result that the internally generated names for the shared memories used no longer fit in the memory provided. . The permitted length is defined in the preprocessor constant KERNELV_INSTANCE_PREFIX_MAX_LEN.
ERR_DOUBLE_INSTANCE | -24 | A kernelv instance was already started from this DLL. It is not possible to start several kernelv instances from an application.
ERR_INVALID_START_MODE | -25 | An invalid start mode was transferred when the function kernelv_ch_program_start() was started. For valid execution mode values, see E_KERNELV_PROG_START_MODE.
ERR_READ_ERR | -26 | An error occurred on reading data from the kernelv DLL.
ERR_WRITE_ERR | -27 | An error occurred when data is written to the kernelv DLL.
ERR_CNC_NO_DATA | -28 | The requested data is not available.
ERR_TECHNO_NOT_FOUND | -29 | The specified technology function was not found.
ERR_INVALID_PARAMETER | -30 | An invalid parameter was transferred.
ERR_STARTUP_CHAN_INIT | -31 | When kernelev-Dll was started, it was not possible to execute the initialisation of the configured NC channels.

Symbol | Value | Meaning
ERR_NC_PROGRAM | -32 | An error has occurred in the NC program.
ERR_CH_ERROR_STATE | -33 | The channel is in error state.
ERR_TIME_OUT | -34 | The function could not be ended within the limit.
ERR_NULL_PARAMETER | -35 | An unreferenced pointer was transferred.