| libimobiledevice 1.4.0 API Documentation - Return to Homepage

mobilebackup_client_free
mobilebackup_client_new
mobilebackup_client_start_service
mobilebackup_client_t
mobilebackup_error_t
mobilebackup_flags_t
mobilebackup_receive
mobilebackup_receive_restore_application_received
mobilebackup_receive_restore_file_received
mobilebackup_request_backup
mobilebackup_request_restore
mobilebackup_send
mobilebackup_send_backup_file_received
mobilebackup_send_error
mobilebackup_send_restore_complete
MOBILEBACKUP_SERVICE_NAME
| ## ◆ mobilebackup_request_restore()
LIBIMOBILEDEVICE_API mobilebackup_error_t mobilebackup_request_restore | ( | mobilebackup_client_t | client,
|  | plist_t | backup_manifest,
|  | mobilebackup_flags_t | flags,
|  | const char * | proto_version )
  Request that a backup should be restored to the connected device. Parameters
  client | The connected MobileBackup client to use.
  backup_manifest | The backup manifest, a plist_t of type PLIST_DICT containing the backup state to be restored.
  flags | Flags to send with the request. Currently this is a combination of the following mobilebackup_flags_t: MB_RESTORE_NOTIFY_SPRINGBOARD - let SpringBoard show a 'Restore' screen MB_RESTORE_PRESERVE_SETTINGS - do not overwrite any settings MB_RESTORE_PRESERVE_CAMERA_ROLL - preserve the photos of the camera roll
  proto_version | A string denoting the version of the backup protocol to use. Latest known version is "1.6". Ideally this value should be extracted from the given manifest plist.
Returns MOBILEBACKUP_E_SUCCESS on success, MOBILEBACKUP_E_INVALID_ARG if one of the parameters is invalid, MOBILEBACKUP_E_PLIST_ERROR if backup_manifest is not of type PLIST_DICT, MOBILEBACKUP_E_MUX_ERROR if a communication error occurs, or MOBILEBACKUP_E_REPLY_NOT_OK if the device did not accept the request.