Elevated install of recovery component (component update part)

chrome/browser/component_updater/component_updater_service.h

 // Copyright 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UPDATER_SERVICE_H_
 #define CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UPDATER_SERVICE_H_
 
 #include <string>
 #include <vector>
 
+#include "base/callback.h"
 #include "base/version.h"
 #include "url/gurl.h"
 
 class ComponentsUI;
 
 namespace base {
 class DictionaryValue;
 class FilePath;
 }
 
 namespace net {
 class URLRequestContextGetter;
 class URLRequest;
 }
 
 namespace content {
 class ResourceThrottle;
 }
 
 namespace component_updater {
 
 class OnDemandUpdater;
 
+typedef base::Callback<bool(const base::FilePath&)> InstallerSourceSerializer;
+
 // Component specific installers must derive from this class and implement
 // OnUpdateError() and Install(). A valid instance of this class must be
 // given to ComponentUpdateService::RegisterComponent().
 class ComponentInstaller {
  public:
   // Called by the component updater on the UI thread when there was a
   // problem unpacking or verifying the component. |error| is a non-zero
   // value which is only meaningful to the component updater.
   virtual void OnUpdateError(int error) = 0;
 
   // Called by the component updater when a component has been unpacked
   // and is ready to be installed. |manifest| contains the CRX manifest
   // json dictionary and |unpack_path| contains the temporary directory
   // with all the unpacked CRX files.
   virtual bool Install(const base::DictionaryValue& manifest,
                        const base::FilePath& unpack_path) = 0;
 
+  // Called by the component updater if Install() retuns false. This gives
+  // installer a chance to handle install failure. |serializer| knows how to
+  // save installer source information to the given path for retry later.
+  virtual void OnInstallError(const InstallerSourceSerializer& serializer) = 0;
+
   // Set |installed_file| to the full path to the installed |file|. |file| is
   // the filename of the file in this component's CRX. Returns false if this is
   // not possible (the file has been removed or modified, or its current
   // location is unknown). Otherwise, returns true.
   virtual bool GetInstalledFile(const std::string& file,
                                 base::FilePath* installed_file) = 0;
 
   virtual ~ComponentInstaller() {}
 };
 
@@ skipping 181 matching lines @@
       const std::string& component_id) = 0;
 };
 
 // Creates the component updater. You must pass a valid |config| allocated on
 // the heap which the component updater will own.
 ComponentUpdateService* ComponentUpdateServiceFactory(
     ComponentUpdateService::Configurator* config);
 }  // namespace component_updater
 
 #endif  // CHROME_BROWSER_COMPONENT_UPDATER_COMPONENT_UPDATER_SERVICE_H_