libimobiledevice  1.3.0
API Documentation - Return to Homepage

◆ instproxy_restore()

instproxy_error_t instproxy_restore ( instproxy_client_t  client,
const char *  appid,
plist_t  client_options,
instproxy_status_cb_t  status_cb,
void *  user_data 
)

Restore a previously archived application on the device.

This function is the counterpart to instproxy_archive.

See also
instproxy_archive
Parameters
clientThe connected installation proxy client
appidApplicationIdentifier of the app to restore.
client_optionsThe client options to use, as PLIST_DICT, or NULL. Valid options include: "ArchiveType" -> "DocumentsOnly"
status_cbCallback function for progress and status information. If NULL is passed, this function will run synchronously.
user_dataCallback data passed to status_cb.
Returns
INSTPROXY_E_SUCCESS on success or an INSTPROXY_E_* error value if an error occurred.
Note
If a callback function is given (async mode), this function returns INSTPROXY_E_SUCCESS immediately if the status updater thread has been created successfully; any error occuring during the command has to be handled inside the specified callback function.