swu_client_register_target_list_notification()

Register a listener to receive notifications about changes to the UpdateTarget list

Synopsis:

#include <swu/UpdateClient.h>

swu_result_t swu_client_register_target_list_notification(
      const swu_client_target_notification_t *notification )

Arguments:

notification
Pointer to an swu_client_target_notification_t structure that defines how to notify a listener of changes to the UpdateTarget list.

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 the UpdateTarget list. This function informs the UpdateClient about a new listener interested in the UpdateTarget list contents. The function is called when a new UpdateTarget is registered with the library or when an existing one is unregistered.

The notification structure isn't copied, so it's expected that the caller maintains 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.