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.
Point Management Application Interface overview. |