Basics

Return codes

group retcode

Defines

DDS_RETCODE_OK

Success

DDS_RETCODE_ERROR

Non specific error

DDS_RETCODE_UNSUPPORTED

Feature unsupported

DDS_RETCODE_BAD_PARAMETER

Bad parameter value

DDS_RETCODE_PRECONDITION_NOT_MET

Precondition for operation not met

DDS_RETCODE_OUT_OF_RESOURCES

When an operation fails because of a lack of resources

DDS_RETCODE_NOT_ENABLED

When a configurable feature is not enabled

DDS_RETCODE_IMMUTABLE_POLICY

When an attempt is made to modify an immutable policy

DDS_RETCODE_INCONSISTENT_POLICY

When a policy is used with inconsistent values

DDS_RETCODE_ALREADY_DELETED

When an attempt is made to delete something more than once

DDS_RETCODE_TIMEOUT

When a timeout has occurred

DDS_RETCODE_NO_DATA

When expected data is not provided

DDS_RETCODE_ILLEGAL_OPERATION

When a function is called when it should not be

DDS_RETCODE_NOT_ALLOWED_BY_SECURITY

When credentials are not enough to use the function

DDS_XRETCODE_BASE

Base offset for extended return codes

DDS_XRETCODE(x)

Extended return code generator

DDS_RETCODE_IN_PROGRESS

Requested resource is busy

DDS_RETCODE_TRY_AGAIN

Resource unavailable, try again

DDS_RETCODE_INTERRUPTED

Operation was interrupted

DDS_RETCODE_NOT_ALLOWED

Permission denied

DDS_RETCODE_HOST_NOT_FOUND

Host not found

DDS_RETCODE_NO_NETWORK

Network is not available

DDS_RETCODE_NO_CONNECTION

Connection is not available

DDS_RETCODE_NOT_ENOUGH_SPACE

Not enough space available

DDS_RETCODE_OUT_OF_RANGE

Result too large

DDS_RETCODE_NOT_FOUND

Not found

Functions

const char *dds_strretcode(dds_return_t ret)

Takes the error value and outputs a string corresponding to it.

Parameters

• ret – [in] Error value to be converted to a string

Returns

String corresponding to the error value