ShellUtil: Add generic methods to add/delete Windows file associations.

chrome/installer/util/shell_util.h

 // Copyright (c) 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.
 //
 // 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_
 
 #include <windows.h>
 
 #include <map>
+#include <set>
 #include <utility>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/files/file_path.h"
 #include "base/logging.h"
 #include "base/memory/ref_counted.h"
 #include "base/strings/string16.h"
 #include "chrome/installer/util/work_item_list.h"
 
 class BrowserDistribution;
 
 namespace base {
 class CancellationFlag;
+class CommandLine;
 }
 
 // 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 554 matching lines @@
   // should call GetCurrentInstallationSuffix().
   static bool GetOldUserSpecificRegistrySuffix(base::string16* suffix);
 
   // Returns the base32 encoding (using the [A-Z2-7] alphabet) of |bytes|.
   // |size| is the length of |bytes|.
   // Note: This method does not suffix the output with '=' signs as technically
   // required by the base32 standard for inputs that aren't a multiple of 5
   // bytes.
   static base::string16 ByteArrayToBase32(const uint8* bytes, size_t size);
 
+  // Associates a set of file extensions with a particular application in the
+  // Windows registry, for the current user only. If an extension has no
+  // existing default association, the given application becomes the default.
+  // Otherwise, the application is added to the Open With menu for this type,
+  // but does not become the default.
+  //
+  // |prog_id| is the ProgId used by Windows for file associations with this
+  // application. Must not be empty or start with a '.'.
+  // |command_line| is the command to execute when opening a file via this
+  // association. It should contain "%1" (to tell Windows to pass the filename
+  // as an argument).
+  // |file_type_name| and |icon_path| are the friendly name, and the path of the
+  // icon, respectively, that will be used for files of these types when
+  // associated with this application by default. (They are NOT the name/icon
+  // that will represent the application under the Open With menu.)
+  // |file_extensions| is the set of extensions to associate. They must not be
+  // empty or start with a '.'.
+  // Returns true on success, false on failure.
+  static bool AddFileAssociations(
+      const base::string16& prog_id,
+      const base::CommandLine& command_line,
+      const base::string16& file_type_name,
+      const base::FilePath& icon_path,
+      const std::set<base::string16>& file_extensions);
+
+  // Deletes all associations with a particular application in the Windows
+  // registry, for the current user only.
+  // |prog_id| is the ProgId used by Windows for file associations with this
+  // application, as given to AddFileAssociations. All information associated
+  // with this name will be deleted.
+  static bool DeleteFileAssociations(const base::string16& prog_id);
+
  private:
   DISALLOW_COPY_AND_ASSIGN(ShellUtil);
 };
 
 
 #endif  // CHROME_INSTALLER_UTIL_SHELL_UTIL_H_