Function wyrd_remove_property_callback

Function Documentation

wyrd_error_t wyrd_remove_property_callback(struct wyrd_handle *handle, char const *path, wyrd_property_callback callback, void *baton)

Remove one instance of the given callback/baton combination from observing the property at the given path.

To ease development for users, calls to wyrd_add_property_callback for each combination are reference counted. This function removes one such reference, and removes the combination entirely if the reference count drops to zero.

Parameters
  • handle[in] A handle to an opened resource.

  • path[in] The path to the property to observe.

  • callback[in] A wyrd_property_callback provided by the user.

  • baton[in] An opaque pointer that will be handled to callback if it gets invoked.

Return values
  • WYRD_ERR_SUCCESS – On success.

  • WYRD_ERR_INVALID_VALUE – If any of the parameters are invalid, such as e.g. NULL when they should not be, etc.