| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 // | 4 // |
| 5 // This file declares methods that are useful for integrating Chrome in | 5 // This file declares methods that are useful for integrating Chrome in |
| 6 // Windows shell. These methods are all static and currently part of | 6 // Windows shell. These methods are all static and currently part of |
| 7 // ShellUtil class. | 7 // ShellUtil class. |
| 8 | 8 |
| 9 #ifndef CHROME_INSTALLER_UTIL_SHELL_UTIL_H_ | 9 #ifndef CHROME_INSTALLER_UTIL_SHELL_UTIL_H_ |
| 10 #define CHROME_INSTALLER_UTIL_SHELL_UTIL_H_ | 10 #define CHROME_INSTALLER_UTIL_SHELL_UTIL_H_ |
| (...skipping 80 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 91 // Sets the target executable to launch from this shortcut. | 91 // Sets the target executable to launch from this shortcut. |
| 92 // This is mandatory when creating a shortcut. | 92 // This is mandatory when creating a shortcut. |
| 93 void set_target(const base::FilePath& target_in) { | 93 void set_target(const base::FilePath& target_in) { |
| 94 target = target_in; | 94 target = target_in; |
| 95 options |= PROPERTIES_TARGET; | 95 options |= PROPERTIES_TARGET; |
| 96 } | 96 } |
| 97 | 97 |
| 98 // Sets the arguments to be passed to |target| when launching from this | 98 // Sets the arguments to be passed to |target| when launching from this |
| 99 // shortcut. | 99 // shortcut. |
| 100 // The length of this string must be less than MAX_PATH. | 100 // The length of this string must be less than MAX_PATH. |
| 101 void set_arguments(const string16& arguments_in) { | 101 void set_arguments(const base::string16& arguments_in) { |
| 102 // Size restriction as per MSDN at | 102 // Size restriction as per MSDN at |
| 103 // http://msdn.microsoft.com/library/windows/desktop/bb774954.aspx. | 103 // http://msdn.microsoft.com/library/windows/desktop/bb774954.aspx. |
| 104 DCHECK(arguments_in.length() < MAX_PATH); | 104 DCHECK(arguments_in.length() < MAX_PATH); |
| 105 arguments = arguments_in; | 105 arguments = arguments_in; |
| 106 options |= PROPERTIES_ARGUMENTS; | 106 options |= PROPERTIES_ARGUMENTS; |
| 107 } | 107 } |
| 108 | 108 |
| 109 // Sets the localized description of the shortcut. | 109 // Sets the localized description of the shortcut. |
| 110 // The length of this string must be less than MAX_PATH. | 110 // The length of this string must be less than MAX_PATH. |
| 111 void set_description(const string16& description_in) { | 111 void set_description(const base::string16& description_in) { |
| 112 // Size restriction as per MSDN at | 112 // Size restriction as per MSDN at |
| 113 // http://msdn.microsoft.com/library/windows/desktop/bb774955.aspx. | 113 // http://msdn.microsoft.com/library/windows/desktop/bb774955.aspx. |
| 114 DCHECK(description_in.length() < MAX_PATH); | 114 DCHECK(description_in.length() < MAX_PATH); |
| 115 description = description_in; | 115 description = description_in; |
| 116 options |= PROPERTIES_DESCRIPTION; | 116 options |= PROPERTIES_DESCRIPTION; |
| 117 } | 117 } |
| 118 | 118 |
| 119 // Sets the path to the icon (icon_index set to 0). | 119 // Sets the path to the icon (icon_index set to 0). |
| 120 // icon index unless otherwise specified in master_preferences). | 120 // icon index unless otherwise specified in master_preferences). |
| 121 void set_icon(const base::FilePath& icon_in, int icon_index_in) { | 121 void set_icon(const base::FilePath& icon_in, int icon_index_in) { |
| 122 icon = icon_in; | 122 icon = icon_in; |
| 123 icon_index = icon_index_in; | 123 icon_index = icon_index_in; |
| 124 options |= PROPERTIES_ICON; | 124 options |= PROPERTIES_ICON; |
| 125 } | 125 } |
| 126 | 126 |
| 127 // Sets the app model id for the shortcut (Win7+). | 127 // Sets the app model id for the shortcut (Win7+). |
| 128 void set_app_id(const string16& app_id_in) { | 128 void set_app_id(const base::string16& app_id_in) { |
| 129 app_id = app_id_in; | 129 app_id = app_id_in; |
| 130 options |= PROPERTIES_APP_ID; | 130 options |= PROPERTIES_APP_ID; |
| 131 } | 131 } |
| 132 | 132 |
| 133 // Forces the shortcut's name to |shortcut_name_in|. | 133 // Forces the shortcut's name to |shortcut_name_in|. |
| 134 // Default: the current distribution's GetShortcutName(SHORTCUT_CHROME). | 134 // Default: the current distribution's GetShortcutName(SHORTCUT_CHROME). |
| 135 // The ".lnk" extension will automatically be added to this name. | 135 // The ".lnk" extension will automatically be added to this name. |
| 136 void set_shortcut_name(const string16& shortcut_name_in) { | 136 void set_shortcut_name(const base::string16& shortcut_name_in) { |
| 137 shortcut_name = shortcut_name_in; | 137 shortcut_name = shortcut_name_in; |
| 138 options |= PROPERTIES_SHORTCUT_NAME; | 138 options |= PROPERTIES_SHORTCUT_NAME; |
| 139 } | 139 } |
| 140 | 140 |
| 141 // Sets whether this is a dual mode shortcut (Win8+). | 141 // Sets whether this is a dual mode shortcut (Win8+). |
| 142 // NOTE: Only the default (no arguments and default browser appid) browser | 142 // NOTE: Only the default (no arguments and default browser appid) browser |
| 143 // shortcut in the Start menu (Start screen on Win8+) should be made dual | 143 // shortcut in the Start menu (Start screen on Win8+) should be made dual |
| 144 // mode. | 144 // mode. |
| 145 void set_dual_mode(bool dual_mode_in) { | 145 void set_dual_mode(bool dual_mode_in) { |
| 146 dual_mode = dual_mode_in; | 146 dual_mode = dual_mode_in; |
| (...skipping 33 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 180 | 180 |
| 181 bool has_dual_mode() const { | 181 bool has_dual_mode() const { |
| 182 return (options & PROPERTIES_DUAL_MODE) != 0; | 182 return (options & PROPERTIES_DUAL_MODE) != 0; |
| 183 } | 183 } |
| 184 | 184 |
| 185 // The level to install this shortcut at (CURRENT_USER for a per-user | 185 // The level to install this shortcut at (CURRENT_USER for a per-user |
| 186 // shortcut and SYSTEM_LEVEL for an all-users shortcut). | 186 // shortcut and SYSTEM_LEVEL for an all-users shortcut). |
| 187 ShellChange level; | 187 ShellChange level; |
| 188 | 188 |
| 189 base::FilePath target; | 189 base::FilePath target; |
| 190 string16 arguments; | 190 base::string16 arguments; |
| 191 string16 description; | 191 base::string16 description; |
| 192 base::FilePath icon; | 192 base::FilePath icon; |
| 193 int icon_index; | 193 int icon_index; |
| 194 string16 app_id; | 194 base::string16 app_id; |
| 195 string16 shortcut_name; | 195 base::string16 shortcut_name; |
| 196 bool dual_mode; | 196 bool dual_mode; |
| 197 bool pin_to_taskbar; | 197 bool pin_to_taskbar; |
| 198 // Bitfield made of IndividualProperties. Properties set in |options| will | 198 // Bitfield made of IndividualProperties. Properties set in |options| will |
| 199 // be used to create/update the shortcut, others will be ignored on update | 199 // be used to create/update the shortcut, others will be ignored on update |
| 200 // and possibly replaced by default values on create (see individual | 200 // and possibly replaced by default values on create (see individual |
| 201 // property setters above for details on default values). | 201 // property setters above for details on default values). |
| 202 uint32 options; | 202 uint32 options; |
| 203 }; | 203 }; |
| 204 | 204 |
| 205 // Relative path of the URL Protocol registry entry (prefixed with '\'). | 205 // Relative path of the URL Protocol registry entry (prefixed with '\'). |
| (...skipping 84 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 290 // Registry value name for the DelegateExecute verb handler. | 290 // Registry value name for the DelegateExecute verb handler. |
| 291 static const wchar_t* kRegDelegateExecute; | 291 static const wchar_t* kRegDelegateExecute; |
| 292 | 292 |
| 293 // Registry value name for the OpenWithProgids entry for file associations. | 293 // Registry value name for the OpenWithProgids entry for file associations. |
| 294 static const wchar_t* kRegOpenWithProgids; | 294 static const wchar_t* kRegOpenWithProgids; |
| 295 | 295 |
| 296 // Returns true if |chrome_exe| is registered in HKLM with |suffix|. | 296 // Returns true if |chrome_exe| is registered in HKLM with |suffix|. |
| 297 // Note: This only checks one deterministic key in HKLM for |chrome_exe| and | 297 // Note: This only checks one deterministic key in HKLM for |chrome_exe| and |
| 298 // doesn't otherwise validate a full Chrome install in HKLM. | 298 // doesn't otherwise validate a full Chrome install in HKLM. |
| 299 static bool QuickIsChromeRegisteredInHKLM(BrowserDistribution* dist, | 299 static bool QuickIsChromeRegisteredInHKLM(BrowserDistribution* dist, |
| 300 const string16& chrome_exe, | 300 const base::string16& chrome_exe, |
| 301 const string16& suffix); | 301 const base::string16& suffix); |
| 302 | 302 |
| 303 // Returns true if the current Windows version supports the presence of | 303 // Returns true if the current Windows version supports the presence of |
| 304 // shortcuts at |location|. | 304 // shortcuts at |location|. |
| 305 static bool ShortcutLocationIsSupported(ShellUtil::ShortcutLocation location); | 305 static bool ShortcutLocationIsSupported(ShellUtil::ShortcutLocation location); |
| 306 | 306 |
| 307 // Sets |path| to the path for a shortcut at the |location| desired for the | 307 // Sets |path| to the path for a shortcut at the |location| desired for the |
| 308 // given |level| (CURRENT_USER for per-user path and SYSTEM_LEVEL for | 308 // given |level| (CURRENT_USER for per-user path and SYSTEM_LEVEL for |
| 309 // all-users path). | 309 // all-users path). |
| 310 // Returns false on failure. | 310 // Returns false on failure. |
| 311 static bool GetShortcutPath(ShellUtil::ShortcutLocation location, | 311 static bool GetShortcutPath(ShellUtil::ShortcutLocation location, |
| (...skipping 11 matching lines...) Expand all Loading... |
| 323 // SHORTCUT_LOCATION_START_MENU_CHROME_DIR, or | 323 // SHORTCUT_LOCATION_START_MENU_CHROME_DIR, or |
| 324 // SHORTCUT_LOCATION_START_MENU_CHROME_APPS_DIR. | 324 // SHORTCUT_LOCATION_START_MENU_CHROME_APPS_DIR. |
| 325 static bool CreateOrUpdateShortcut( | 325 static bool CreateOrUpdateShortcut( |
| 326 ShellUtil::ShortcutLocation location, | 326 ShellUtil::ShortcutLocation location, |
| 327 BrowserDistribution* dist, | 327 BrowserDistribution* dist, |
| 328 const ShellUtil::ShortcutProperties& properties, | 328 const ShellUtil::ShortcutProperties& properties, |
| 329 ShellUtil::ShortcutOperation operation); | 329 ShellUtil::ShortcutOperation operation); |
| 330 | 330 |
| 331 // Returns the string "|icon_path|,|icon_index|" (see, for example, | 331 // Returns the string "|icon_path|,|icon_index|" (see, for example, |
| 332 // http://msdn.microsoft.com/library/windows/desktop/dd391573.aspx). | 332 // http://msdn.microsoft.com/library/windows/desktop/dd391573.aspx). |
| 333 static string16 FormatIconLocation(const string16& icon_path, int icon_index); | 333 static base::string16 FormatIconLocation(const base::string16& icon_path, |
| 334 int icon_index); |
| 334 | 335 |
| 335 // This method returns the command to open URLs/files using chrome. Typically | 336 // This method returns the command to open URLs/files using chrome. Typically |
| 336 // this command is written to the registry under shell\open\command key. | 337 // this command is written to the registry under shell\open\command key. |
| 337 // |chrome_exe|: the full path to chrome.exe | 338 // |chrome_exe|: the full path to chrome.exe |
| 338 static string16 GetChromeShellOpenCmd(const string16& chrome_exe); | 339 static base::string16 GetChromeShellOpenCmd(const base::string16& chrome_exe); |
| 339 | 340 |
| 340 // This method returns the command to be called by the DelegateExecute verb | 341 // This method returns the command to be called by the DelegateExecute verb |
| 341 // handler to launch chrome on Windows 8. Typically this command is written to | 342 // handler to launch chrome on Windows 8. Typically this command is written to |
| 342 // the registry under the HKCR\Chrome\.exe\shell\(open|run)\command key. | 343 // the registry under the HKCR\Chrome\.exe\shell\(open|run)\command key. |
| 343 // |chrome_exe|: the full path to chrome.exe | 344 // |chrome_exe|: the full path to chrome.exe |
| 344 static string16 GetChromeDelegateCommand(const string16& chrome_exe); | 345 static base::string16 GetChromeDelegateCommand( |
| 346 const base::string16& chrome_exe); |
| 345 | 347 |
| 346 // Gets a mapping of all registered browser names (excluding browsers in the | 348 // Gets a mapping of all registered browser names (excluding browsers in the |
| 347 // |dist| distribution) and their reinstall command (which usually sets | 349 // |dist| distribution) and their reinstall command (which usually sets |
| 348 // browser as default). | 350 // browser as default). |
| 349 // Given browsers can be registered in HKCU (as of Win7) and/or in HKLM, this | 351 // Given browsers can be registered in HKCU (as of Win7) and/or in HKLM, this |
| 350 // method looks in both and gives precedence to values in HKCU as per the msdn | 352 // method looks in both and gives precedence to values in HKCU as per the msdn |
| 351 // standard: http://goo.gl/xjczJ. | 353 // standard: http://goo.gl/xjczJ. |
| 352 static void GetRegisteredBrowsers(BrowserDistribution* dist, | 354 static void GetRegisteredBrowsers( |
| 353 std::map<string16, string16>* browsers); | 355 BrowserDistribution* dist, |
| 356 std::map<base::string16, base::string16>* browsers); |
| 354 | 357 |
| 355 // Returns the suffix this user's Chrome install is registered with. | 358 // Returns the suffix this user's Chrome install is registered with. |
| 356 // Always returns the empty string on system-level installs. | 359 // Always returns the empty string on system-level installs. |
| 357 // | 360 // |
| 358 // This method is meant for external methods which need to know the suffix of | 361 // This method is meant for external methods which need to know the suffix of |
| 359 // the current install at run-time, not for install-time decisions. | 362 // the current install at run-time, not for install-time decisions. |
| 360 // There are no guarantees that this suffix will not change later: | 363 // There are no guarantees that this suffix will not change later: |
| 361 // (e.g. if two user-level installs were previously installed in parallel on | 364 // (e.g. if two user-level installs were previously installed in parallel on |
| 362 // the same machine, both without admin rights and with no user-level install | 365 // the same machine, both without admin rights and with no user-level install |
| 363 // having claimed the non-suffixed HKLM registrations, they both have no | 366 // having claimed the non-suffixed HKLM registrations, they both have no |
| 364 // suffix in their progId entries (as per the old suffix rules). If they were | 367 // suffix in their progId entries (as per the old suffix rules). If they were |
| 365 // to both fully register (i.e. click "Make Chrome Default" and go through | 368 // to both fully register (i.e. click "Make Chrome Default" and go through |
| 366 // UAC; or upgrade to Win8 and get the automatic no UAC full registration) | 369 // UAC; or upgrade to Win8 and get the automatic no UAC full registration) |
| 367 // they would then both get a suffixed registration as per the new suffix | 370 // they would then both get a suffixed registration as per the new suffix |
| 368 // rules). | 371 // rules). |
| 369 // | 372 // |
| 370 // |chrome_exe| The path to the currently installed (or running) chrome.exe. | 373 // |chrome_exe| The path to the currently installed (or running) chrome.exe. |
| 371 static string16 GetCurrentInstallationSuffix(BrowserDistribution* dist, | 374 static base::string16 GetCurrentInstallationSuffix( |
| 372 const string16& chrome_exe); | 375 BrowserDistribution* dist, |
| 376 const base::string16& chrome_exe); |
| 373 | 377 |
| 374 // Returns the application name of the program under |dist|. | 378 // Returns the application name of the program under |dist|. |
| 375 // This application name will be suffixed as is appropriate for the current | 379 // This application name will be suffixed as is appropriate for the current |
| 376 // install. | 380 // install. |
| 377 // This is the name that is registered with Default Programs on Windows and | 381 // This is the name that is registered with Default Programs on Windows and |
| 378 // that should thus be used to "make chrome default" and such. | 382 // that should thus be used to "make chrome default" and such. |
| 379 static string16 GetApplicationName(BrowserDistribution* dist, | 383 static base::string16 GetApplicationName(BrowserDistribution* dist, |
| 380 const string16& chrome_exe); | 384 const base::string16& chrome_exe); |
| 381 | 385 |
| 382 // Returns the AppUserModelId for |dist|. This identifier is unconditionally | 386 // Returns the AppUserModelId for |dist|. This identifier is unconditionally |
| 383 // suffixed with a unique id for this user on user-level installs (in contrast | 387 // suffixed with a unique id for this user on user-level installs (in contrast |
| 384 // to other registration entries which are suffixed as described in | 388 // to other registration entries which are suffixed as described in |
| 385 // GetCurrentInstallationSuffix() above). | 389 // GetCurrentInstallationSuffix() above). |
| 386 static string16 GetBrowserModelId(BrowserDistribution* dist, | 390 static base::string16 GetBrowserModelId(BrowserDistribution* dist, |
| 387 bool is_per_user_install); | 391 bool is_per_user_install); |
| 388 | 392 |
| 389 // Returns an AppUserModelId composed of each member of |components| separated | 393 // Returns an AppUserModelId composed of each member of |components| separated |
| 390 // by dots. | 394 // by dots. |
| 391 // The returned appid is guaranteed to be no longer than | 395 // The returned appid is guaranteed to be no longer than |
| 392 // chrome::kMaxAppModelIdLength (some of the components might have been | 396 // chrome::kMaxAppModelIdLength (some of the components might have been |
| 393 // shortened to enforce this). | 397 // shortened to enforce this). |
| 394 static string16 BuildAppModelId(const std::vector<string16>& components); | 398 static base::string16 BuildAppModelId( |
| 399 const std::vector<base::string16>& components); |
| 395 | 400 |
| 396 // Returns true if Chrome can make itself the default browser without relying | 401 // Returns true if Chrome can make itself the default browser without relying |
| 397 // on the Windows shell to prompt the user. This is the case for versions of | 402 // on the Windows shell to prompt the user. This is the case for versions of |
| 398 // Windows prior to Windows 8. | 403 // Windows prior to Windows 8. |
| 399 static bool CanMakeChromeDefaultUnattended(); | 404 static bool CanMakeChromeDefaultUnattended(); |
| 400 | 405 |
| 401 // Returns the DefaultState of Chrome for HTTP and HTTPS. | 406 // Returns the DefaultState of Chrome for HTTP and HTTPS. |
| 402 static DefaultState GetChromeDefaultState(); | 407 static DefaultState GetChromeDefaultState(); |
| 403 | 408 |
| 404 // Returns the DefaultState of Chrome for |protocol|. | 409 // Returns the DefaultState of Chrome for |protocol|. |
| 405 static DefaultState GetChromeDefaultProtocolClientState( | 410 static DefaultState GetChromeDefaultProtocolClientState( |
| 406 const string16& protocol); | 411 const base::string16& protocol); |
| 407 | 412 |
| 408 // Make Chrome the default browser. This function works by going through | 413 // Make Chrome the default browser. This function works by going through |
| 409 // the url protocols and file associations that are related to general | 414 // the url protocols and file associations that are related to general |
| 410 // browsing, e.g. http, https, .html etc., and requesting to become the | 415 // browsing, e.g. http, https, .html etc., and requesting to become the |
| 411 // default handler for each. If any of these fails the operation will return | 416 // default handler for each. If any of these fails the operation will return |
| 412 // false to indicate failure, which is consistent with the return value of | 417 // false to indicate failure, which is consistent with the return value of |
| 413 // ShellIntegration::GetDefaultBrowser. | 418 // ShellIntegration::GetDefaultBrowser. |
| 414 // | 419 // |
| 415 // In the case of failure any successful changes will be left, however no | 420 // In the case of failure any successful changes will be left, however no |
| 416 // more changes will be attempted. | 421 // more changes will be attempted. |
| 417 // TODO(benwells): Attempt to undo any changes that were successfully made. | 422 // TODO(benwells): Attempt to undo any changes that were successfully made. |
| 418 // http://crbug.com/83970 | 423 // http://crbug.com/83970 |
| 419 // | 424 // |
| 420 // shell_change: Defined whether to register as default browser at system | 425 // shell_change: Defined whether to register as default browser at system |
| 421 // level or user level. If value has ShellChange::SYSTEM_LEVEL | 426 // level or user level. If value has ShellChange::SYSTEM_LEVEL |
| 422 // we should be running as admin user. | 427 // we should be running as admin user. |
| 423 // chrome_exe: The chrome.exe path to register as default browser. | 428 // chrome_exe: The chrome.exe path to register as default browser. |
| 424 // elevate_if_not_admin: On Vista if user is not admin, try to elevate for | 429 // elevate_if_not_admin: On Vista if user is not admin, try to elevate for |
| 425 // Chrome registration. | 430 // Chrome registration. |
| 426 static bool MakeChromeDefault(BrowserDistribution* dist, | 431 static bool MakeChromeDefault(BrowserDistribution* dist, |
| 427 int shell_change, | 432 int shell_change, |
| 428 const string16& chrome_exe, | 433 const base::string16& chrome_exe, |
| 429 bool elevate_if_not_admin); | 434 bool elevate_if_not_admin); |
| 430 | 435 |
| 431 // Shows and waits for the Windows 8 "How do you want to open webpages?" | 436 // Shows and waits for the Windows 8 "How do you want to open webpages?" |
| 432 // dialog if Chrome is not already the default HTTP/HTTPS handler. Also does | 437 // dialog if Chrome is not already the default HTTP/HTTPS handler. Also does |
| 433 // XP-era registrations if Chrome is chosen or was already the default. Do | 438 // XP-era registrations if Chrome is chosen or was already the default. Do |
| 434 // not use on pre-Win8 OSes. | 439 // not use on pre-Win8 OSes. |
| 435 // | 440 // |
| 436 // |dist| gives the type of browser distribution currently in use. | 441 // |dist| gives the type of browser distribution currently in use. |
| 437 // |chrome_exe| The chrome.exe path to register as default browser. | 442 // |chrome_exe| The chrome.exe path to register as default browser. |
| 438 static bool ShowMakeChromeDefaultSystemUI(BrowserDistribution* dist, | 443 static bool ShowMakeChromeDefaultSystemUI(BrowserDistribution* dist, |
| 439 const string16& chrome_exe); | 444 const base::string16& chrome_exe); |
| 440 | 445 |
| 441 // Make Chrome the default application for a protocol. | 446 // Make Chrome the default application for a protocol. |
| 442 // chrome_exe: The chrome.exe path to register as default browser. | 447 // chrome_exe: The chrome.exe path to register as default browser. |
| 443 // protocol: The protocol to register as the default handler for. | 448 // protocol: The protocol to register as the default handler for. |
| 444 static bool MakeChromeDefaultProtocolClient(BrowserDistribution* dist, | 449 static bool MakeChromeDefaultProtocolClient(BrowserDistribution* dist, |
| 445 const string16& chrome_exe, | 450 const base::string16& chrome_exe, |
| 446 const string16& protocol); | 451 const base::string16& protocol); |
| 447 | 452 |
| 448 // Shows and waits for the Windows 8 "How do you want to open links of this | 453 // Shows and waits for the Windows 8 "How do you want to open links of this |
| 449 // type?" dialog if Chrome is not already the default |protocol| | 454 // type?" dialog if Chrome is not already the default |protocol| |
| 450 // handler. Also does XP-era registrations if Chrome is chosen or was already | 455 // handler. Also does XP-era registrations if Chrome is chosen or was already |
| 451 // the default for |protocol|. Do not use on pre-Win8 OSes. | 456 // the default for |protocol|. Do not use on pre-Win8 OSes. |
| 452 // | 457 // |
| 453 // |dist| gives the type of browser distribution currently in use. | 458 // |dist| gives the type of browser distribution currently in use. |
| 454 // |chrome_exe| The chrome.exe path to register as default browser. | 459 // |chrome_exe| The chrome.exe path to register as default browser. |
| 455 // |protocol| is the protocol being registered. | 460 // |protocol| is the protocol being registered. |
| 456 static bool ShowMakeChromeDefaultProtocolClientSystemUI( | 461 static bool ShowMakeChromeDefaultProtocolClientSystemUI( |
| 457 BrowserDistribution* dist, | 462 BrowserDistribution* dist, |
| 458 const string16& chrome_exe, | 463 const base::string16& chrome_exe, |
| 459 const string16& protocol); | 464 const base::string16& protocol); |
| 460 | 465 |
| 461 // Registers Chrome as a potential default browser and handler for filetypes | 466 // Registers Chrome as a potential default browser and handler for filetypes |
| 462 // and protocols. | 467 // and protocols. |
| 463 // If Chrome is already registered, this method is a no-op. | 468 // If Chrome is already registered, this method is a no-op. |
| 464 // This method requires write access to HKLM (prior to Win8) so is just a | 469 // This method requires write access to HKLM (prior to Win8) so is just a |
| 465 // best effort deal. | 470 // best effort deal. |
| 466 // If write to HKLM is required, but fails, and: | 471 // If write to HKLM is required, but fails, and: |
| 467 // - |elevate_if_not_admin| is true (and OS is Vista or above): | 472 // - |elevate_if_not_admin| is true (and OS is Vista or above): |
| 468 // tries to launch setup.exe with admin priviledges (by prompting the user | 473 // tries to launch setup.exe with admin priviledges (by prompting the user |
| 469 // with a UAC) to do these tasks. | 474 // with a UAC) to do these tasks. |
| 470 // - |elevate_if_not_admin| is false (or OS is XP): | 475 // - |elevate_if_not_admin| is false (or OS is XP): |
| 471 // adds the ProgId entries to HKCU. These entries will not make Chrome show | 476 // adds the ProgId entries to HKCU. These entries will not make Chrome show |
| 472 // in Default Programs but they are still useful because Chrome can be | 477 // in Default Programs but they are still useful because Chrome can be |
| 473 // registered to run when the user clicks on an http link or an html file. | 478 // registered to run when the user clicks on an http link or an html file. |
| 474 // | 479 // |
| 475 // |chrome_exe| full path to chrome.exe. | 480 // |chrome_exe| full path to chrome.exe. |
| 476 // |unique_suffix| Optional input. If given, this function appends the value | 481 // |unique_suffix| Optional input. If given, this function appends the value |
| 477 // to default browser entries names that it creates in the registry. | 482 // to default browser entries names that it creates in the registry. |
| 478 // Currently, this is only used to continue an install with the same suffix | 483 // Currently, this is only used to continue an install with the same suffix |
| 479 // when elevating and calling setup.exe with admin privileges as described | 484 // when elevating and calling setup.exe with admin privileges as described |
| 480 // above. | 485 // above. |
| 481 // |elevate_if_not_admin| if true will make this method try alternate methods | 486 // |elevate_if_not_admin| if true will make this method try alternate methods |
| 482 // as described above. This should only be true when following a user action | 487 // as described above. This should only be true when following a user action |
| 483 // (e.g. "Make Chrome Default") as it allows this method to UAC. | 488 // (e.g. "Make Chrome Default") as it allows this method to UAC. |
| 484 // | 489 // |
| 485 // Returns true if Chrome is successfully registered (or already registered). | 490 // Returns true if Chrome is successfully registered (or already registered). |
| 486 static bool RegisterChromeBrowser(BrowserDistribution* dist, | 491 static bool RegisterChromeBrowser(BrowserDistribution* dist, |
| 487 const string16& chrome_exe, | 492 const base::string16& chrome_exe, |
| 488 const string16& unique_suffix, | 493 const base::string16& unique_suffix, |
| 489 bool elevate_if_not_admin); | 494 bool elevate_if_not_admin); |
| 490 | 495 |
| 491 // This method declares to Windows that Chrome is capable of handling the | 496 // This method declares to Windows that Chrome is capable of handling the |
| 492 // given protocol. This function will call the RegisterChromeBrowser function | 497 // given protocol. This function will call the RegisterChromeBrowser function |
| 493 // to register with Windows as capable of handling the protocol, if it isn't | 498 // to register with Windows as capable of handling the protocol, if it isn't |
| 494 // currently registered as capable. | 499 // currently registered as capable. |
| 495 // Declaring the capability of handling a protocol is necessary to register | 500 // Declaring the capability of handling a protocol is necessary to register |
| 496 // as the default handler for the protocol in Vista and later versions of | 501 // as the default handler for the protocol in Vista and later versions of |
| 497 // Windows. | 502 // Windows. |
| 498 // | 503 // |
| 499 // If called by the browser and elevation is required, it will elevate by | 504 // If called by the browser and elevation is required, it will elevate by |
| 500 // calling setup.exe which will again call this function with elevate false. | 505 // calling setup.exe which will again call this function with elevate false. |
| 501 // | 506 // |
| 502 // |chrome_exe| full path to chrome.exe. | 507 // |chrome_exe| full path to chrome.exe. |
| 503 // |unique_suffix| Optional input. If given, this function appends the value | 508 // |unique_suffix| Optional input. If given, this function appends the value |
| 504 // to default browser entries names that it creates in the registry. | 509 // to default browser entries names that it creates in the registry. |
| 505 // |protocol| The protocol to register as being capable of handling.s | 510 // |protocol| The protocol to register as being capable of handling.s |
| 506 // |elevate_if_not_admin| if true will make this method try alternate methods | 511 // |elevate_if_not_admin| if true will make this method try alternate methods |
| 507 // as described above. | 512 // as described above. |
| 508 static bool RegisterChromeForProtocol(BrowserDistribution* dist, | 513 static bool RegisterChromeForProtocol(BrowserDistribution* dist, |
| 509 const string16& chrome_exe, | 514 const base::string16& chrome_exe, |
| 510 const string16& unique_suffix, | 515 const base::string16& unique_suffix, |
| 511 const string16& protocol, | 516 const base::string16& protocol, |
| 512 bool elevate_if_not_admin); | 517 bool elevate_if_not_admin); |
| 513 | 518 |
| 514 // Removes installed shortcut(s) at |location|. | 519 // Removes installed shortcut(s) at |location|. |
| 515 // |level|: CURRENT_USER to remove per-user shortcuts, or SYSTEM_LEVEL to | 520 // |level|: CURRENT_USER to remove per-user shortcuts, or SYSTEM_LEVEL to |
| 516 // remove all-users shortcuts. | 521 // remove all-users shortcuts. |
| 517 // |target_exe|: Shortcut target exe; shortcuts will only be deleted when | 522 // |target_exe|: Shortcut target exe; shortcuts will only be deleted when |
| 518 // their target is |target_exe|. | 523 // their target is |target_exe|. |
| 519 // If |location| is a Chrome-specific folder, it will be deleted as well. | 524 // If |location| is a Chrome-specific folder, it will be deleted as well. |
| 520 // Returns true if all shortcuts pointing to |target_exe| are successfully | 525 // Returns true if all shortcuts pointing to |target_exe| are successfully |
| 521 // deleted, including the case where no such shortcuts are found. | 526 // deleted, including the case where no such shortcuts are found. |
| (...skipping 21 matching lines...) Expand all Loading... |
| 543 // (including the '.'). | 548 // (including the '.'). |
| 544 // This suffix is then meant to be added to all registration that may conflict | 549 // This suffix is then meant to be added to all registration that may conflict |
| 545 // with another user-level Chrome install. | 550 // with another user-level Chrome install. |
| 546 // Note that prior to Chrome 21, the suffix registered used to be the user's | 551 // Note that prior to Chrome 21, the suffix registered used to be the user's |
| 547 // username (see GetOldUserSpecificRegistrySuffix() below). We still honor old | 552 // username (see GetOldUserSpecificRegistrySuffix() below). We still honor old |
| 548 // installs registered that way, but it was wrong because some of the | 553 // installs registered that way, but it was wrong because some of the |
| 549 // characters allowed in a username are not allowed in a ProgId. | 554 // characters allowed in a username are not allowed in a ProgId. |
| 550 // Returns true unless the OS call to retrieve the username fails. | 555 // Returns true unless the OS call to retrieve the username fails. |
| 551 // NOTE: Only the installer should use this suffix directly. Other callers | 556 // NOTE: Only the installer should use this suffix directly. Other callers |
| 552 // should call GetCurrentInstallationSuffix(). | 557 // should call GetCurrentInstallationSuffix(). |
| 553 static bool GetUserSpecificRegistrySuffix(string16* suffix); | 558 static bool GetUserSpecificRegistrySuffix(base::string16* suffix); |
| 554 | 559 |
| 555 // Sets |suffix| to this user's username preceded by a dot. This suffix should | 560 // Sets |suffix| to this user's username preceded by a dot. This suffix should |
| 556 // only be used to support legacy installs that used this suffixing | 561 // only be used to support legacy installs that used this suffixing |
| 557 // style. | 562 // style. |
| 558 // Returns true unless the OS call to retrieve the username fails. | 563 // Returns true unless the OS call to retrieve the username fails. |
| 559 // NOTE: Only the installer should use this suffix directly. Other callers | 564 // NOTE: Only the installer should use this suffix directly. Other callers |
| 560 // should call GetCurrentInstallationSuffix(). | 565 // should call GetCurrentInstallationSuffix(). |
| 561 static bool GetOldUserSpecificRegistrySuffix(string16* suffix); | 566 static bool GetOldUserSpecificRegistrySuffix(base::string16* suffix); |
| 562 | 567 |
| 563 // Returns the base32 encoding (using the [A-Z2-7] alphabet) of |bytes|. | 568 // Returns the base32 encoding (using the [A-Z2-7] alphabet) of |bytes|. |
| 564 // |size| is the length of |bytes|. | 569 // |size| is the length of |bytes|. |
| 565 // Note: This method does not suffix the output with '=' signs as technically | 570 // Note: This method does not suffix the output with '=' signs as technically |
| 566 // required by the base32 standard for inputs that aren't a multiple of 5 | 571 // required by the base32 standard for inputs that aren't a multiple of 5 |
| 567 // bytes. | 572 // bytes. |
| 568 static string16 ByteArrayToBase32(const uint8* bytes, size_t size); | 573 static base::string16 ByteArrayToBase32(const uint8* bytes, size_t size); |
| 569 | 574 |
| 570 private: | 575 private: |
| 571 DISALLOW_COPY_AND_ASSIGN(ShellUtil); | 576 DISALLOW_COPY_AND_ASSIGN(ShellUtil); |
| 572 }; | 577 }; |
| 573 | 578 |
| 574 | 579 |
| 575 #endif // CHROME_INSTALLER_UTIL_SHELL_UTIL_H_ | 580 #endif // CHROME_INSTALLER_UTIL_SHELL_UTIL_H_ |
| OLD | NEW |