Upgrade Guide - Prolifics

sm_com_onerrorInstalls an error handlervoid sm_com_onerror(char *handler);handlerThe name of the error handler. This C function or JPL procedure will bepassed three parameters:errorNumberThe error number as an integer. Use this value to test for errors.errorHexidecimalThe error number as a string in hexadecimal format, as in0x80000307. (This parameter is displayed by the default errorhandler.)errorMessageThe text description of the error. (This parameter is displayed by thedefault error handler.)EnvironmentScopeDescriptionWindowsClientsm_com_onerror specifies the error handler that will be called if a COM operationreturns a negative exception. The return from the handler is ignored. Usage of thisfunction is no longer recommended; use sm_obj_onerror instead to ensurecomponent portability.An error handler will only be fired on negative exception codes; use sm_com_resultto retrieve positive exceptions.If you do not want an error handler, you must install your own error handler that simplereturns.To restore the default error handler, use sm_com_onerror(0).C-12 Obsolete Functions