swu_update_list_iterate()

Iterate over the contents of an UpdateList

Synopsis:

#include <swu/UpdateClient.h>

swu_result_t swu_update_list_iterate( 
                        swu_update_list_t list,
                        swu_update_list_iterator_t iterator,
                        void *context)

Arguments:

list
Handle of an UpdateList to iterate through.
iterator
Callback function to use for iterating over the list contents.
context
Context pointer that will be passed to the callback function.

Library:

libswu-core

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

Description:

Iterate over the contents of the UpdateList specified in list. After a call to this function completes successfully, the library calls the callback function specified in iterator once for each list item (i.e., Update object) and then a final time with an swu_update_t value of NULL to indicate the end of the list.

Returns:

One of the following swu_result_t values:

SWU_RESULT_SUCCESS
The operation succeeded.
SWU_RESULT_INVALID_ARGUMENT
An invalid argument was given.
SWU_RESULT_ERROR
Another error occurred.