Support for interactive set-chrome-as-default in Windows.

chrome/browser/shell_integration.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.
 
 #ifndef CHROME_BROWSER_SHELL_INTEGRATION_H_
 #define CHROME_BROWSER_SHELL_INTEGRATION_H_
 #pragma once
 
 #include <string>
 
 #include "base/basictypes.h"
 #include "base/file_path.h"
 #include "base/memory/ref_counted.h"
 #include "base/string16.h"
 #include "googleurl/src/gurl.h"
 #include "ui/gfx/image/image.h"
 
 class CommandLine;
 
 class ShellIntegration {
  public:
   // Sets Chrome as the default browser (only for the current user). Returns
   // false if this operation fails.
   static bool SetAsDefaultBrowser();
 
+  // Initializes an OS shell flow which (if followed by the user) should set
+  // Chrome as the default browser. Returns false if the flow cannot be
+  // initialized or if it is not supported (introduced for Windows 8).
+  static bool StartSetAsDefaultBrowserInteractive();

[grt (UTC plus 2), 2012/05/28 20:47:02]

The name "StartBlaBlah" makes me think that this might kick off an async
operation.  is this the case, or is it a blocking operation?  please document
one way or the other.

Should the comment really begin with "Initiates" rather than "Initializes"?  If
the function returns true, does the caller need to know anything about how the
OS shell flow terminates?

How about when the function returns false?  Is that only due to an error?

Must this only be called from a certain thread?

[motek., 2012/05/31 21:59:04]

Done.

+
   // Sets Chrome as the default client application for the given protocol
   // (only for the current user). Returns false if this operation fails.
   static bool SetAsDefaultProtocolClient(const std::string& protocol);
 
-  // Returns true if the running browser can be set as the default browser.
-  static bool CanSetAsDefaultBrowser();
+  // In Windows 8 a browser can be made default-in-metro only in an interactive
+  // flow. We will distinguish between two types of permissions here to avoid
+  // forcing the user into UI interaction when this should not be done.
+  enum DefaultSettingsChangePermission {
+    CHANGE_DEFAULT_NOT_ALLOWED = 0,
+    CHANGE_DEFAULT_UNATTENDED,
+    CHANGE_DEFAULT_INTERACTIVE,
+  };
 
-  // Returns true if the running browser can be set as the default client
-  // application for specific protocols.
-  static bool CanSetAsDefaultProtocolClient();
+  // Returns requirements for making the running browser the user's default.
+  static DefaultSettingsChangePermission CanSetAsDefaultBrowser();
+
+  // Returns requirements for making the running browser the user's default
+  // client application for specific protocols.
+  static DefaultSettingsChangePermission CanSetAsDefaultProtocolClient();
 
   // On Linux, it may not be possible to determine or set the default browser
   // on some desktop environments or configurations. So, we use this enum and
   // not a plain bool. (Note however that if used like a bool, this enum will
   // have reasonable behavior.)
   enum DefaultWebClientState {
     NOT_DEFAULT_WEB_CLIENT = 0,
     IS_DEFAULT_WEB_CLIENT,
     UNKNOWN_DEFAULT_WEB_CLIENT = -1
   };
@@ skipping 209 matching lines @@
     // Set Chrome as the default handler for this protocol.
     virtual void SetAsDefault() OVERRIDE;
 
     std::string protocol_;
 
     DISALLOW_COPY_AND_ASSIGN(DefaultProtocolClientWorker);
   };
 };
 
 #endif  // CHROME_BROWSER_SHELL_INTEGRATION_H_