Function anjay_advanced_fw_update_get_linked_instances

Function Documentation

int anjay_advanced_fw_update_get_linked_instances(anjay_t *anjay, anjay_iid_t iid, const anjay_iid_t **out_target_iids, size_t *out_target_iids_count)

Gets linked instances resource of Advance Firmware Update object instance.

Linked instances mark instances that will be updated in a batch together when performing upgrade of a iid instance. See AVSystem specification of Advanced Firmware Update for details.

NOTE: The returned array points directly into the internal structures of Anjay; however, it may only be modified by a call to anjay_advanced_fw_update_set_linked_instances . Nevertheless, if your code calls the “get” and “set” functions from different threads, the calls need to be additionally synchronized to achieve thread safety.

Parameters:

  • anjay – Anjay object to operate on.

  • iid – Instance ID of an Advanced Firmware Object.

  • out_target_iids – Points to memory where to write array of iids of linked instances.

  • out_target_iids_count – Point to memory where to write count of target iids in an array.

Returns:

0 on success, or a negative value in case of error.