Conferencing API Programming Guide — August 2006 17
4
4.Error Handling
This chapter describes error handling for the conferencing software.
All conferencing functions return a value that indicates the success or failure of the function call.
Success is indicated by a return value of CNF_SUCCESS. Failure is indicated by a value of
CNF_ERROR.
If a function fails, call the Standard Attribute functions ATDV_LASTERR( ) and
ATDV_ERRMSGP( ) for the reason for failure. These functions are described in the Standard
Runtime Library API Library Reference.
If an error occurs during execution of an asynchronous function, the CNFEV_ERROR event is sent
to the application. No change of state is triggered by this event. Upon receiving the
CNFEV_ERROR event, the application can retrieve the reason for the failure using the standard
runtime library functions ATDV_LASTERR( ) and ATDV_ERRMSGP( ).