7.  Errors

A description of error handling and retrieval, including a summary of possible errors returned, is presented in this chapter.

7.1.  Error Handling and Retrieval

All library functions return a value to the application that indicates the success or failure of the function call. A function can return either of the following:

• 0 indicating success
• -1 indicating the function failed

NOTE:

The scx_open( ) function returns the device handle on success instead of 0. However, like the other functions, scx_open( ) returns -1 on failure.

When a function returns a -1, the specific error code indicating the cause of the failure can be retrieved by the ATDV_LASTERR( ) function found in the standard runtime library. The ATDV_ERRMSGP( ) SRL function may be called to obtain the descriptive ASCII error message returned by the function that failed.

Click here to contact Dialogic Customer Engineering