swu_target_not_ready_to_install()

Inform the UpdateClient that a target isn't ready to install an update

Synopsis:

#include <swu/UpdateTargetInterface.h>
 
swu_result_t swu_target_not_ready_to_install( 
                                swu_target_id_t id, 
                                swu_update_t update, 
                                swu_failure_reason_t reason, 
                                swu_failure_code_t code )

Arguments:

id
ID of the UpdateTarget that's not ready to install an update. This ID was assigned by the library in the call to swu_target_register().
update
Handle of an Update object containing an update that the client is trying to install.
reason
Constant defined by the swu_failure_reason_t enumeration for indicating that the target is not ready for an update (SWU_FAILURE_REASON_NOT_READY_FOR_UPDATE).
code
User-defined error code to help determine the issue preventing the target from installing the update. This value is only passed through and isn't used by the library, but logging this value can be handy for debugging.

Library:

libswu-core

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

Description:

Inform the UpdateClient that a target isn't ready to install an update. The UpdateTarget indicated in id calls this function after determining that the target is not ready to install the update specified in update. It's expected that the UpdateTarget call this function after returning from the prepare_to_install function referenced in its associated swu_target_interface_t structure.

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.