 |
PK_DEBUG_try_error_handler |
|
PK_ERROR_code_t PK_DEBUG_try_error_handler
(
--- received arguments ---
PK_DEBUG_try_error_handler_f_t function, --- function to be called
PK_POINTER_t context, --- context for function
const PK_DEBUG_try_error_handler_o_t *options --- options structure
)
This function calls the supplied function with the supplied
context from within executing Parasolid. The supplied function
is called immediately, rather than being remembered for later
use. The point of this is to allow testing of run-time error
handlers, by calling functions that cause run-time errors, or
call PK_SESSION_abort; it has no use in modelling.
Note that while any application error handler registered with
PK_ERROR_register_callbacks will be called if the function
supplied to PK_DEBUG_try_error_handler causes a run-time error,
PK_DEBUG_try_error_handler is not specific to application error
handlers and can be used even if no application error handler
has been registered.
Function argumemts:
'function' The function to be called to try your application's error
handler. This should create a run-time error, or call
PK_SESSION_abort. See the Signal Handling
chapter of the Functional Description for information
on run-time errors and error handling.
'context' Context to be provided to the function. Parasolid makes
no use of this value; it is provided to allow you to
pass any required data to the function.
'options' Options structure. See PK_DEBUG_try_error_handler_o_t for
details.
See here for more information.
Please note that testing an error handler with this function
cannot provide complete assurance that an error handler will
deal with all possible error conditions. It is not possible to
anticipate all possible combinations of circumstances within a
system as complex as Parasolid.