swu_update_list_register_notification()

Register a listener to receive notifications about changes to an UpdateList

Synopsis:

#include <swu/UpdateClient.h>

swu_result_t swu_update_list_register_notification(
        swu_update_list_t list, 
        const swu_update_list_notification_t *notification )

Arguments:

list
Handle of an UpdateList for which the caller wants to receive notifications of content changes.
notification
Pointer to an swu_update_list_notification_t structure that defines how to notify a listener of changes to the UpdateList.

Library:

libswu-core

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

Description:

Register a listener to receive notifications about changes to an UpdateList. This function informs the UpdateClient about a new listener interested in the contents of the UpdateList referenced in list.

The notification structure isn't copied, so the caller is expected to maintain this structure. After the notification is successfully registered, the callback function referred to in notification gets called.

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.