PTMAP Error Handling

Errors that occur during calls to PTMAP are recorded in the COR_STATUS structure and returned to the application. Unless noted otherwise in the function descriptions, all PTMAP functions return either COR_SUCCESS, COR_WARNING, or COR_FAILURE. If either COR_WARNING or COR_FAILURE is returned, additional information is returned in the status structure: the err_msg field is filled with an error message and the err_code field contains the PTMAP error code.

The COR_STATUS structure definition:

typedef struct cor_status
{
????COR_I4????????????status;??????????????/* success, failure, or warning */
????COR_I4????????????err_source;??????/* what detected the error */
????COR_I4????????????err_code;??????????/* what the error code is */
????COR_I4????????????err_ref;????????????/* where the error occurred */
????COR_BOOLEAN err_reported;??/* has it been logged yet? */
????char????????????????err_msg[80]??????/* any text message */
}
????COR_STATUS;

A list of error codes for all Point Management processes is included in Appendix A.