API Return Codes

Navigation:  NxLib API > C Interface >

API Return Codes

Previous pageReturn to chapter overviewNext page

All function accessing the NxLib tree items return error codes from the following list:

 

NxLibOperationSucceeded

The operation completed successfully. No error occurred.

NxLibCannotCreateItem

You tried to write to an item which is access restricted, or cannot be created because the subtree it belongs to is access restricted.

NxLibCouldNotInterpretJsonText

You specified a JSON string which could not be interpreted.

NxLibItemInexistent

The item you tried to access does not exist.

NxLibCouldNotOpenPort

NxLibRemote only: the specified port could not be allocated.

NxLibInternalError

An unknown internal error occurred.

NxLibTimeout

NxLibRemote only: the operation timed out, most likely the TCP connection was interrupted.

NxLibNotConnected

NxLibRemote only: the operation cannot be performed because there is no connection to any NxLib instance.

NxLibCouldNotLockTree

There was a failure acquiring exclusive access to the parameter tree.

NxLibItemTypeNotCompatible

You tried to read a value of a certain type from an item, but the item is of a different type.

NxLibBufferTooSmall

Returned by nxLibGetBinary when the item could not be copied to the users buffer, because the buffer was too small.

NxLibBufferNotDivisibleByElementSize

C++ only: You specified a std::vector<T> to NxLibItem::getBinaryData(), but the size of the Binary item data is not divisible by sizeof(T).

NxLibExecutionFailed

C++ only: You used the NxLibCommand::execute() function, but the command execution returned an error. Use NxLibCommand::result()[itmErrorSymbol] and NxLibCommand::result()[itmErrorText] items to determine the exact nature of the failure.

NxLibDebugMessageOverflow

Returned by nxLibGetDebugMessages if the message buffer has overflown and older messages had to be dropped.

NxLibNoDebugData

Returned by nxLibGetDebugMessages if the message buffer is empty.

NxLibInvalidBufferSize

Returned by nxLibSetBinary if the buffer size was invalid (e.g. did not match the current node data size).