Specify a callback for error conditions¶
saf_setProps_ErrFunc
is a function defined in libprops.c.
Synopsis:
-
int
saf_setProps_ErrFunc
(SAF_LibProps *properties, SAF_ErrFunc func)¶
Formal Arguments:
properties
: The library property list which will be modified by this function (See *Properties*).func
: The callback to invoke when an error occurs.
Description: The specified function (or no function if func
is the null pointer) will be called when the library is
recovering from an error condition. The default is that no callback is invoked.
Preconditions:
properties
must be a valid library properties handle. (low-cost)
Return Value: The constant SAF__SUCCESS
is returned when this function is successful. Otherwise this function either returns
an error number or throws an exception, depending on the value of the library’s error handling property.
Issues: Not implemented yet (always returns SAF__NOTIMPL_ERROR
).
See Also:
- Library Properties: Introduction for current chapter