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: