swu_object_retain()

Arguments:

object

An swu_object returned from an earlier API call.

Library:

Use the -l swu-core option with qcc to link against the SWU library. This library is usually included automatically.

Description:

Retain an swu_object previously returned by another API call. This function increments the reference counts of objects returned in calls to the SWU library API. Such objects include swu_string_t, swu_update_t, swu_target_t, and others.

You must call this function to increase an object's reference count if you want to maintain access to that object. Any object that has its reference count increased this way must be released later with swu_object_release() when no longer needed.