blob: bea3e759b06a86ab9ca221dbe88677bbabe45abe [file] [log] [blame]
// 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.
// Implementation of the CommandExecuteImpl class which implements the
// IExecuteCommand and related interfaces for handling ShellExecute based
// launches of the Chrome browser.
#include "win8/delegate_execute/command_execute_impl.h"
#include <shlguid.h>
#include "base/files/file_util.h"
#include "base/path_service.h"
#include "base/process/launch.h"
#include "base/process/process_handle.h"
#include "base/strings/utf_string_conversions.h"
#include "base/win/message_window.h"
#include "base/win/registry.h"
#include "base/win/scoped_co_mem.h"
#include "base/win/scoped_handle.h"
#include "base/win/scoped_process_information.h"
#include "base/win/win_util.h"
#include "chrome/common/chrome_constants.h"
#include "chrome/common/chrome_paths.h"
#include "chrome/common/chrome_switches.h"
#include "chrome/installer/util/browser_distribution.h"
#include "chrome/installer/util/install_util.h"
#include "chrome/installer/util/shell_util.h"
#include "chrome/installer/util/util_constants.h"
#include "ui/base/clipboard/clipboard_util_win.h"
#include "ui/base/ui_base_switches.h"
#include "ui/gfx/win/dpi.h"
#include "win8/delegate_execute/chrome_util.h"
#include "win8/delegate_execute/delegate_execute_util.h"
#include "win8/viewer/metro_viewer_constants.h"
namespace {
// Helper function to retrieve the url from IShellItem interface passed in.
// Returns S_OK on success.
HRESULT GetUrlFromShellItem(IShellItem* shell_item, base::string16* url) {
// First attempt to get the url from the underlying IDataObject if any. This
// ensures that we get the full url, i.e. including the anchor.
// If we fail to get the underlying IDataObject we retrieve the url via the
// IShellItem::GetDisplayName function.
CComPtr<IDataObject> object;
HRESULT hr = shell_item->BindToHandler(NULL,
if (SUCCEEDED(hr)) {
if (ui::ClipboardUtil::GetPlainText(object, url))
return S_OK;
base::win::ScopedCoMem<wchar_t> name;
hr = shell_item->GetDisplayName(SIGDN_URL, &name);
if (hr != S_OK) {
AtlTrace("Failed to get display name\n");
return hr;
*url = static_cast<const wchar_t*>(name);
AtlTrace("Retrieved url from display name %ls\n", url->c_str());
return S_OK;
bool LaunchChromeBrowserProcess() {
base::FilePath delegate_exe_path;
if (!PathService::Get(base::FILE_EXE, &delegate_exe_path))
return false;
// First try and go up a level to find chrome.exe.
base::FilePath chrome_exe_path =
if (!base::PathExists(chrome_exe_path)) {
// Try looking in the current directory if we couldn't find it one up in
// order to support developer installs.
chrome_exe_path =
if (!base::PathExists(chrome_exe_path)) {
AtlTrace("Could not locate chrome.exe at: %ls\n",
return false;
CommandLine cl(chrome_exe_path);
// Prevent a Chrome window from showing up on the desktop.
// Tell Chrome to connect to the Metro viewer process.
base::LaunchOptions launch_options;
launch_options.start_hidden = true;
return base::LaunchProcess(cl, launch_options, NULL);
} // namespace
bool CommandExecuteImpl::path_provider_initialized_ = false;
// CommandExecuteImpl is responsible for activating chrome in Windows 8. The
// flow is complicated and this tries to highlight the important events.
// The current approach is to have a single instance of chrome either
// running in desktop or metro mode. If there is no current instance then
// the desktop shortcut launches desktop chrome and the metro tile or search
// charm launches metro chrome.
// If chrome is running then focus/activation is given to the existing one
// regardless of what launch point the user used.
// The general flow for activation is as follows:
// 1- User interacts with launch point (icon, tile, search, shellexec, etc)
// 2- Windows finds the appid for launch item and resolves it to chrome
// 3- Windows activates CommandExecuteImpl inside a surrogate process
// 4- Windows calls the following sequence of entry points:
// CommandExecuteImpl::SetShowWindow
// CommandExecuteImpl::SetPosition
// CommandExecuteImpl::SetDirectory
// CommandExecuteImpl::SetParameter
// CommandExecuteImpl::SetNoShowUI
// CommandExecuteImpl::SetSelection
// CommandExecuteImpl::Initialize
// Up to this point the code basically just gathers values passed in, like
// the launch scheme (or url) and the activation verb.
// 5- Windows calls CommandExecuteImpl::Getvalue()
// Here we need to return AHE_IMMERSIVE or AHE_DESKTOP. That depends on:
// a) if run in high-integrity return AHE_DESKTOP.
// b) else we return what GetLaunchMode() tells us, which is:
// i) if chrome is not the default browser, return AHE_DESKTOP
// ii) if the command line --force-xxx is present return that
// iii) if the registry 'launch_mode' exists return that
// iv) else return AHE_DESKTOP
// 6- If we returned AHE_IMMERSIVE in step 5 windows might not call us back
// and simply activate chrome in metro by itself, however in some cases
// it might proceed at step 7.
// As far as we know if we return AHE_DESKTOP then step 7 always happens.
// 7- Windows calls CommandExecuteImpl::Execute()
// Here we call GetLaunchMode() which returns the cached answer
// computed at step 5c. which can be:
// a) ECHUIM_DESKTOP then we call LaunchDesktopChrome() that calls
// ::CreateProcess and we exit at this point even on failure.
// b) else we call one of the IApplicationActivationManager activation
// functions depending on the parameters passed in step 4.
// c) If the activation returns E_APPLICATION_NOT_REGISTERED, then we fall
// back to launching chrome on the desktop via LaunchDestopChrome(). Note
// that this case can lead to strange behavior, because at this point we
// have pre-launched the browser with:
// --silent-launch --connect-to-metro-viewer.
// E_APPLICATION_NOT_REGISTERED is always returned if Chrome is not the
// default browser (this case will have already been checked for by
// GetLaunchMode() and AHE_DESKTOP returned), but we don't know if it can
// be returned for other reasons.
// Note that if a command line --force-xxx is present we write that launch mode
// in the registry so next time the logic reaches 5c-ii it will use the same
// mode again.
: parameters_(CommandLine::NO_PROGRAM),
integrity_level_(base::INTEGRITY_UNKNOWN) {
memset(&start_info_, 0, sizeof(start_info_));
start_info_.cb = sizeof(start_info_);
// We need to query the user data dir of chrome so we need chrome's
// path provider. We can be created multiple times in a single instance
// however so make sure we do this only once.
if (!path_provider_initialized_) {
path_provider_initialized_ = true;
// CommandExecuteImpl
STDMETHODIMP CommandExecuteImpl::SetKeyState(DWORD key_state) {
return S_OK;
STDMETHODIMP CommandExecuteImpl::SetParameters(LPCWSTR params) {
parameters_ = delegate_execute::CommandLineFromParameters(params);
return S_OK;
STDMETHODIMP CommandExecuteImpl::SetPosition(POINT pt) {
return S_OK;
STDMETHODIMP CommandExecuteImpl::SetShowWindow(int show) {
start_info_.wShowWindow = show;
start_info_.dwFlags |= STARTF_USESHOWWINDOW;
return S_OK;
STDMETHODIMP CommandExecuteImpl::SetNoShowUI(BOOL no_show_ui) {
return S_OK;
STDMETHODIMP CommandExecuteImpl::SetDirectory(LPCWSTR directory) {
return S_OK;
STDMETHODIMP CommandExecuteImpl::GetValue(enum AHE_TYPE* pahe) {
if (!GetLaunchScheme(&display_name_, &launch_scheme_)) {
AtlTrace("Failed to get scheme, E_FAIL\n");
return E_FAIL;
EC_HOST_UI_MODE mode = GetLaunchMode();
// If we're going to return AHE_IMMERSIVE, then both the browser process and
// the metro viewer need to launch and connect before the user can start
// browsing. However we must not launch the metro viewer until we get a
// call to CommandExecuteImpl::Execute(). If we wait until then to launch
// the browser process as well, it will appear laggy while they connect to
// each other, so we pre-launch the browser process now.
if (*pahe == AHE_IMMERSIVE && verb_ != win8::kMetroViewerConnectVerb) {
return S_OK;
STDMETHODIMP CommandExecuteImpl::Execute() {
AtlTrace("In %hs\n", __FUNCTION__);
if (integrity_level_ == base::HIGH_INTEGRITY)
return LaunchDesktopChrome();
EC_HOST_UI_MODE mode = GetLaunchMode();
if (mode == ECHUIM_DESKTOP)
return LaunchDesktopChrome();
CComPtr<IApplicationActivationManager> activation_manager;
hr = activation_manager.CoCreateInstance(CLSID_ApplicationActivationManager);
if (!activation_manager) {
AtlTrace("Failed to get the activation manager, error 0x%x\n", hr);
return S_OK;
BrowserDistribution* distribution = BrowserDistribution::GetDistribution();
bool is_per_user_install = InstallUtil::IsPerUserInstall(
base::string16 app_id = ShellUtil::GetBrowserModelId(
distribution, is_per_user_install);
DWORD pid = 0;
if (launch_scheme_ == INTERNET_SCHEME_FILE &&
display_name_.find(installer::kChromeExe) != base::string16::npos) {
AtlTrace("Activating for file\n");
hr = activation_manager->ActivateApplication(app_id.c_str(),
} else {
AtlTrace("Activating for protocol\n");
hr = activation_manager->ActivateForProtocol(app_id.c_str(),
AtlTrace("Metro chrome is not registered, launching in desktop\n");
return LaunchDesktopChrome();
AtlTrace("Metro Chrome launch, pid=%d, returned 0x%x\n", pid, hr);
return S_OK;
STDMETHODIMP CommandExecuteImpl::Initialize(LPCWSTR name,
IPropertyBag* bag) {
if (!FindChromeExe(&chrome_exe_))
return E_FAIL;
if (name) {
AtlTrace("Verb is %S\n", name);
verb_ = name;
return S_OK;
STDMETHODIMP CommandExecuteImpl::SetSelection(IShellItemArray* item_array) {
item_array_ = item_array;
return S_OK;
STDMETHODIMP CommandExecuteImpl::GetSelection(REFIID riid, void** selection) {
return S_OK;
STDMETHODIMP CommandExecuteImpl::AllowForegroundTransfer(void* reserved) {
return S_OK;
// Returns false if chrome.exe cannot be found.
// static
bool CommandExecuteImpl::FindChromeExe(base::FilePath* chrome_exe) {
// Look for chrome.exe one folder above delegate_execute.exe (as expected in
// Chrome installs). Failing that, look for it alonside delegate_execute.exe.
base::FilePath dir_exe;
if (!PathService::Get(base::DIR_EXE, &dir_exe)) {
AtlTrace("Failed to get current exe path\n");
return false;
*chrome_exe = dir_exe.DirName().Append(chrome::kBrowserProcessExecutableName);
if (!base::PathExists(*chrome_exe)) {
*chrome_exe = dir_exe.Append(chrome::kBrowserProcessExecutableName);
if (!base::PathExists(*chrome_exe)) {
AtlTrace("Failed to find chrome exe file\n");
return false;
return true;
bool CommandExecuteImpl::GetLaunchScheme(
base::string16* display_name, INTERNET_SCHEME* scheme) {
if (!item_array_)
return false;
DWORD count = 0;
if (count != 1) {
AtlTrace("Cannot handle %d elements in the IShellItemArray\n", count);
return false;
CComPtr<IEnumShellItems> items;
CComPtr<IShellItem> shell_item;
HRESULT hr = items->Next(1, &shell_item, &count);
if (hr != S_OK) {
AtlTrace("Failed to read element from the IShellItemsArray\n");
return false;
hr = GetUrlFromShellItem(shell_item, display_name);
if (FAILED(hr)) {
AtlTrace("Failed to get url. Error 0x%x\n", hr);
return false;
wchar_t scheme_name[16];
URL_COMPONENTS components = {0};
components.lpszScheme = scheme_name;
components.dwSchemeLength = sizeof(scheme_name)/sizeof(scheme_name[0]);
components.dwStructSize = sizeof(components);
if (!InternetCrackUrlW(display_name->c_str(), 0, 0, &components)) {
AtlTrace("Failed to crack url %ls\n", display_name->c_str());
return false;
AtlTrace("Launch scheme is [%ls] (%d)\n", scheme_name, components.nScheme);
*scheme = components.nScheme;
return true;
HRESULT CommandExecuteImpl::LaunchDesktopChrome() {
base::string16 display_name = display_name_;
switch (launch_scheme_) {
// If anything other than chrome.exe is passed in the display name we
// should honor it. For e.g. If the user clicks on a html file when
// chrome is the default we should treat it as a parameter to be passed
// to chrome.
if (display_name.find(installer::kChromeExe) != base::string16::npos)
CommandLine chrome(
delegate_execute::MakeChromeCommandLine(chrome_exe_, parameters_,
base::string16 command_line(chrome.GetCommandLineString());
AtlTrace("Formatted command line is %ls\n", command_line.c_str());
PROCESS_INFORMATION temp_process_info = {};
BOOL ret = CreateProcess(chrome_exe_.value().c_str(),
NULL, NULL, FALSE, 0, NULL, NULL, &start_info_,
if (ret) {
base::win::ScopedProcessInformation proc_info(temp_process_info);
AtlTrace("Process id is %d\n", proc_info.process_id());
} else {
AtlTrace("Process launch failed, error %d\n", ::GetLastError());
return S_OK;
EC_HOST_UI_MODE CommandExecuteImpl::GetLaunchMode() {
// See the header file for an explanation of the mode selection logic.
static bool launch_mode_determined = false;
static EC_HOST_UI_MODE launch_mode = ECHUIM_DESKTOP;
const char* modes[] = { "Desktop", "Immersive", "SysLauncher", "??" };
if (launch_mode_determined)
return launch_mode;
if (integrity_level_ == base::HIGH_INTEGRITY) {
// Metro mode apps don't work in high integrity mode.
AtlTrace("High integrity: launching in desktop mode\n");
launch_mode = ECHUIM_DESKTOP;
launch_mode_determined = true;
return launch_mode;
base::FilePath chrome_exe;
if (!FindChromeExe(&chrome_exe) ||
ShellUtil::GetChromeDefaultStateFromPath(chrome_exe) !=
ShellUtil::IS_DEFAULT) {
AtlTrace("Chrome is not default: launching in desktop mode\n");
launch_mode = ECHUIM_DESKTOP;
launch_mode_determined = true;
return launch_mode;
if (GetAsyncKeyState(VK_SHIFT) && GetAsyncKeyState(VK_F11)) {
AtlTrace("Hotkey: launching in immersive mode\n");
launch_mode = ECHUIM_IMMERSIVE;
launch_mode_determined = true;
return launch_mode;
// From here on, if we can, we will write the outcome
// of this function to the registry.
if (parameters_.HasSwitch(switches::kForceImmersive)) {
launch_mode = ECHUIM_IMMERSIVE;
launch_mode_determined = true;
parameters_ = CommandLine(CommandLine::NO_PROGRAM);
} else if (parameters_.HasSwitch(switches::kForceDesktop)) {
launch_mode = ECHUIM_DESKTOP;
launch_mode_determined = true;
parameters_ = CommandLine(CommandLine::NO_PROGRAM);
base::win::RegKey reg_key;
LONG key_result = reg_key.Create(HKEY_CURRENT_USER,
if (key_result != ERROR_SUCCESS) {
AtlTrace("Failed to open HKCU %ls key, error 0x%x\n",
if (!launch_mode_determined) {
// If we cannot open the key and we don't know the
// launch mode we default to desktop mode.
launch_mode = ECHUIM_DESKTOP;
launch_mode_determined = true;
return launch_mode;
if (launch_mode_determined) {
AtlTrace("Launch mode forced by cmdline to %s\n", modes[launch_mode]);
return launch_mode;
// Use the previous mode if available. Else launch in desktop mode.
DWORD reg_value;
if (reg_key.ReadValueDW(chrome::kLaunchModeValue,
&reg_value) != ERROR_SUCCESS) {
launch_mode = ECHUIM_DESKTOP;
AtlTrace("Can't read registry, defaulting to %s\n", modes[launch_mode]);
} else if (reg_value >= ECHUIM_SYSTEM_LAUNCHER) {
AtlTrace("Invalid registry launch mode value %u\n", reg_value);
launch_mode = ECHUIM_DESKTOP;
} else {
launch_mode = static_cast<EC_HOST_UI_MODE>(reg_value);
AtlTrace("Launch mode forced by registry to %s\n", modes[launch_mode]);
launch_mode_determined = true;
return launch_mode;