Add Windows desktop shortcut for multiple profiles.

chrome/installer/util/shell_util.h

 // Copyright (c) 2011 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.
 //
 // This file declares methods that are useful for integrating Chrome in
 // Windows shell. These methods are all static and currently part of
 // ShellUtil class.
 
 #ifndef CHROME_INSTALLER_UTIL_SHELL_UTIL_H_
 #define CHROME_INSTALLER_UTIL_SHELL_UTIL_H_
 #pragma once
 
 #include <windows.h>
 #include <map>
 #include <string>
 
 #include "base/basictypes.h"
 #include "chrome/installer/util/work_item_list.h"
 
 class BrowserDistribution;
 class FilePath;
 
+namespace base {
+class DictionaryValue;
+}
+
 // This is a utility class that provides common shell integration methods
 // that can be used by installer as well as Chrome.
 class ShellUtil {
  public:
   // Input to any methods that make changes to OS shell.
   enum ShellChange {
     CURRENT_USER = 0x1,  // Make any shell changes only at the user level
     SYSTEM_LEVEL = 0x2   // Make any shell changes only at the system level
   };
 
@@ skipping 47 matching lines @@
   static const wchar_t* kPotentialProtocolAssociations[];
 
   // Registry value name that is needed for ChromeHTML ProgId
   static const wchar_t* kRegUrlProtocol;
 
   // Checks if we need Admin rights for registry cleanup by checking if any
   // entry exists in HKLM.
   static bool AdminNeededForRegistryCleanup(BrowserDistribution* dist,
                                             const std::wstring& suffix);
 
-  // Create Chrome shortcut on Desktop
-  // If shell_change is CURRENT_USER, the shortcut is created in the
-  // Desktop folder of current user's profile.
-  // If shell_change is SYSTEM_LEVEL, the shortcut is created in the
-  // Desktop folder of "All Users" profile.
-  // If alternate is true, an alternate text for the shortcut is used.
-  // create_new: If false, will only update the shortcut. If true, the function
-  //             will create a new shortcut if it doesn't exist already.
+  // Creates Chrome shortcut on the Desktop.
+  // |dist| gives the type of browser distribution currently in use.
+  // |chrome_exe| provides the target path information.
+  // |description| provides the shortcut's "comment" property.
+  // |appended_name| provides a string to be appended to the distribution name,
+  //     and can be the empty string.
+  // |arguments| gives a set of arguments to be passed to the executable.
+  // If |shell_change| is CURRENT_USER, the shortcut is created in the
+  //     Desktop folder of current user's profile.
+  // If |shell_change| is SYSTEM_LEVEL, the shortcut is created in the
+  //     Desktop folder of the "All Users" profile.
+  // If |alternate| is true, an alternate text for the shortcut is used.
+  // If |create_new| is false, an existing shortcut will be updated, but if
+  //     no shortcut exists, it will not be created.
   // Returns true iff the method causes a shortcut to be created / updated.
   static bool CreateChromeDesktopShortcut(BrowserDistribution* dist,
                                           const std::wstring& chrome_exe,
                                           const std::wstring& description,
+                                          const std::wstring& appended_name,
+                                          const std::wstring& arguments,
                                           ShellChange shell_change,
                                           bool alternate,
                                           bool create_new);
 
   // Create Chrome shortcut on Quick Launch Bar.
   // If shell_change is CURRENT_USER, the shortcut is created in the
   // Quick Launch folder of current user's profile.
   // If shell_change is SYSTEM_LEVEL, the shortcut is created in the
   // Quick Launch folder of "Default User" profile. This will make sure
   // that this shortcut will be seen by all the new users logging into the
@@ skipping 10 matching lines @@
   // Chrome icon that can be used as value for Windows registry keys.
   // |chrome_exe| full path to chrome.exe.
   static std::wstring GetChromeIcon(BrowserDistribution* dist,
                                     const std::wstring& chrome_exe);
 
   // This method returns the command to open URLs/files using chrome. Typically
   // this command is written to the registry under shell\open\command key.
   // chrome_exe: the full path to chrome.exe
   static std::wstring GetChromeShellOpenCmd(const std::wstring& chrome_exe);
 
-  // Returns the localized name of Chrome shortcut. If |alternate| is true
-  // it returns a second localized text that is better suited for certain
-  // scenarios.
+  // Returns the localized name of Chrome shortcut in |shortcut|. If
+  // |appended_name| is not empty, it is included in the shortcut name. If
+  // |alternate| is true, a second localized text that is better suited for
+  // certain scenarios is used.
   static bool GetChromeShortcutName(BrowserDistribution* dist,
-                                    std::wstring* shortcut, bool alternate);
+                                    bool alternate,
+                                    const std::wstring& appended_name,
+                                    std::wstring* shortcut);
 
   // Gets the desktop path for the current user or all users (if system_level
   // is true) and returns it in 'path' argument. Return true if successful,
   // otherwise returns false.
   static bool GetDesktopPath(bool system_level, FilePath* path);
 
   // Gets the Quick Launch shortcuts path for the current user and
   // returns it in 'path' argument. Return true if successful, otherwise
   // returns false. If system_level is true this function returns the path
   // to Default Users Quick Launch shortcuts path. Adding a shortcut to Default
@@ skipping 96 matching lines @@
                                         bool elevate_if_not_admin);
 
   // Remove Chrome shortcut from Desktop.
   // If shell_change is CURRENT_USER, the shortcut is removed from the
   // Desktop folder of current user's profile.
   // If shell_change is SYSTEM_LEVEL, the shortcut is removed from the
   // Desktop folder of "All Users" profile.
   // If alternate is true, the shortcut with the alternate name is removed. See
   // CreateChromeDesktopShortcut() for more information.
   static bool RemoveChromeDesktopShortcut(BrowserDistribution* dist,
-                                          int shell_change, bool alternate);
+                                          int shell_change,
+                                          bool alternate);
+
+  // Removes a set of existing Chrome desktop shortcuts. |appended_names| is a
+  // list of shortcut file names as obtained from
+  // ShellUtil::GetChromeShortcutName.
+  static bool RemoveChromeDesktopShortcutsWithAppendedNames(
+      const std::vector<std::wstring>& appended_names);
 
   // Remove Chrome shortcut from Quick Launch Bar.
   // If shell_change is CURRENT_USER, the shortcut is removed from
   // the Quick Launch folder of current user's profile.
   // If shell_change is SYSTEM_LEVEL, the shortcut is removed from
   // the Quick Launch folder of "Default User" profile.
   static bool RemoveChromeQuickLaunchShortcut(BrowserDistribution* dist,
                                               int shell_change);
 
   // Updates shortcut (or creates a new shortcut) at destination given by
-  // shortcut to a target given by chrome_exe. The arguments is left NULL
-  // for the target and icon is set as icon at index 0 from exe.
+  // shortcut to a target given by chrome_exe. The arguments are given by
+  // |arguments| for the target and icon is set as icon at index 0 from exe.
   // If create_new is set to true, the function will create a new shortcut if
   // if doesn't exist.
   static bool UpdateChromeShortcut(BrowserDistribution* dist,
                                    const std::wstring& chrome_exe,
                                    const std::wstring& shortcut,
+                                   const std::wstring& arguments,
                                    const std::wstring& description,
                                    bool create_new);
 
  private:
   DISALLOW_COPY_AND_ASSIGN(ShellUtil);
 };
 
 
 #endif  // CHROME_INSTALLER_UTIL_SHELL_UTIL_H_