fp_error()
Go Up to Callback Functions
int (*fp_error)(MSG_NO msg_no, void *error_arg, const TEXT* context)
fp_error() is a callback function supplied by you, the developer. It accepts an error number, msg_no, when a pointer to it is passed to either isc_install_execute() or isc_uninstall_execute() as a parameter.
| Parameter | Type | Description |
|---|---|---|
|
<msg_no> |
|
Accepts an error number from either |
|
<error_arg> |
|
A pointer to optional user-defined data passed to |
|
<context> |
|
Provides additional information about the nature of the error that can be passed on to the end user |
Return value: fp_error() processes the error message and returns one of three values: isc_install_ fp_retry, isc_install_ fp_continue, or isc_install_ fp_abort.
| fp_error() returns | Effect on calling function |
|---|---|
|
<isc_install_ fp_abort> |
Action fails and calling function returns with the same error |
|
<isc_install_ fp_retry> |
Action is retried but will probably fail again unless user has intervened |
|
<isc_install_ fp_continue> |
Function ignores the error and continues from the point where the error occurred |
- Important: These callback functions can make calls only to
isc_install_get_message(). The result is undetermined if they attempt to call any other Install API function.