Chapter 5 Error Codes

TIBCO SmartSockets provides some simple error handling for its C API functions. The error handling system provides additional information about why a function call failed. This is most often found in functions that return a TRUE or FALSE status.

For function calls that support error handling, the global SmartSockets error number is set to a value that provides additional information about why the function failed. This global error number can be retrieved with TutErrNumGet and set with TutErrNumSet. In multithreaded programs, the global error number is stored in a value for each thread.

To simplify logging or printing notification of errors, a string describing the error can be retrieved with TutErrStrGet or TutErrNumToStr.

The Diagnostics section of each function in the TIBCO SmartSockets Application Programming Interface describes how error handling is supported. The error number should only be used immediately after a failure value is returned by a function that supports error handling. At any other time, the value of the error number is meaningless.

Topics