chrome/installer/setup/uninstall.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4 //
   5 // This file declares Chrome uninstall related functions.
   6
   7 #ifndef CHROME_INSTALLER_SETUP_UNINSTALL_H_
   8 #define CHROME_INSTALLER_SETUP_UNINSTALL_H_
   9
  10 #include <shlobj.h>
  11
  12 #include "base/strings/string16.h"
  13 #include "chrome/installer/util/util_constants.h"
  14
  15 class BrowserDistribution;
  16 class CommandLine;
  17
  18 namespace base {
  19 class FilePath;
  20 }
  21
  22 namespace installer {
  23
  24 class InstallationState;
  25 class InstallerState;
  26 class Product;
  27
  28 enum DeleteResult {
  29   DELETE_SUCCEEDED,
  30   DELETE_NOT_EMPTY,
  31   DELETE_FAILED,
  32   DELETE_REQUIRES_REBOOT,
  33 };
  34
  35 // Deletes |target_directory| (".../Application") and the vendor directories
  36 // (e.g., ".../Google/Chrome") if they are empty. Returns DELETE_SUCCEEDED if
  37 // either the directories were deleted or if they were not empty. Returns
  38 // DELETE_FAILED if any could not be deleted due to an error.
  39 DeleteResult DeleteChromeDirectoriesIfEmpty(
  40     const base::FilePath& application_directory);
  41
  42 // This function removes all Chrome registration related keys. It returns true
  43 // if successful, otherwise false. The error code is set in |exit_code|.
  44 // |root| is the registry root (HKLM|HKCU) and |browser_entry_suffix| is the
  45 // suffix for default browser entry name in the registry (optional).
  46 bool DeleteChromeRegistrationKeys(const InstallerState& installer_state,
  47                                   BrowserDistribution* dist,
  48                                   HKEY root,
  49                                   const base::string16& browser_entry_suffix,
  50                                   InstallStatus* exit_code);
  51
  52 // Removes any legacy registry keys from earlier versions of Chrome that are no
  53 // longer needed. This is used during autoupdate since we don't do full
  54 // uninstalls/reinstalls to update.
  55 void RemoveChromeLegacyRegistryKeys(BrowserDistribution* dist,
  56                                     const base::string16& chrome_exe);
  57
  58 // This function uninstalls a product.  Hence we came up with this awesome
  59 // name for it.
  60 //
  61 // original_state: The installation state of all products on the system.
  62 // installer_state: State associated with this operation.
  63 // setup_path: Path to the executable (setup.exe) as it will be copied
  64 //           to temp folder before deleting Chrome folder.
  65 // dist: Represents the distribution to be uninstalled.
  66 // remove_all: Remove all shared files, registry entries as well.
  67 // force_uninstall: Uninstall without prompting for user confirmation or
  68 //                  any checks for Chrome running.
  69 // cmd_line: CommandLine that contains information about the command that
  70 //           was used to launch current uninstaller.
  71 installer::InstallStatus UninstallProduct(
  72     const InstallationState& original_state,
  73     const InstallerState& installer_state,
  74     const base::FilePath& setup_path,
  75     const Product& dist,
  76     bool remove_all,
  77     bool force_uninstall,
  78     const CommandLine& cmd_line);
  79
  80 // Cleans up the installation directory after all uninstall operations have
  81 // completed. Depending on what products are remaining, setup.exe and the
  82 // installer archive may be deleted. Empty directories will be pruned (or
  83 // scheduled for pruning after reboot, if necessary).
  84 //
  85 // original_state: The installation state of all products on the system.
  86 // installer_state: State associated with this operation.
  87 // cmd_line: CommandLine that contains information about the command that
  88 //           was used to launch current uninstaller.
  89 // uninstall_status: the uninstall status so far (may change during invocation).
  90 void CleanUpInstallationDirectoryAfterUninstall(
  91     const InstallationState& original_state,
  92     const InstallerState& installer_state,
  93     const CommandLine& cmd_line,
  94     InstallStatus* uninstall_status);
  95
  96 }  // namespace installer
  97
  98 #endif  // CHROME_INSTALLER_SETUP_UNINSTALL_H_