chrome/installer/util/install_service_work_item.h

// Copyright 2018 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
//
// This module is responsible for installing a service, given a |service_name|,
// |display_name|, and |service_cmd_line|. If the service already exists, a
// light-weight upgrade of the service will be performed, to reduce the chances
// of anti-virus flagging issues with deleting/installing a new service.
// In the event that the upgrade fails, this module will install a new service
// and mark the original service for deletion.

#ifndef CHROME_INSTALLER_UTIL_INSTALL_SERVICE_WORK_ITEM_H_
#define CHROME_INSTALLER_UTIL_INSTALL_SERVICE_WORK_ITEM_H_

#include <memory>
#include <string>
#include <vector>

#include "base/strings/cstring_view.h"
#include "chrome/installer/util/work_item.h"

namespace base {
class CommandLine;
}  // namespace base

namespace installer {

class InstallServiceWorkItemImpl;

// A generic WorkItem subclass that installs a Windows Service for Chrome.
class InstallServiceWorkItem : public WorkItem {
 public:
  // |service_name| is the name given to the service. In the case of a conflict
  // when upgrading the service, this will be the prefix for a versioned name
  // given to the service.
  // An example |service_name| could be "elevationservice".
  //
  // |display_name| is the human-readable name that is visible in the Service
  // control panel. For example, "Chrome Elevation Service".
  //
  // |description| is the human-readable description, a comment that explains
  // the purpose of the service, and is visible in the Service control panel.
  // For example, "Foo Service keeps Bar up to date".
  //
  // |start_type| is typically SERVICE_DEMAND_START or SERVICE_AUTO_START.
  //
  // |service_cmd_line| is the command line with which the service is invoked by
  // the SCM. For example,
  // "C:\Program Files (x86)\Google\Chrome\ElevationService.exe" /svc
  //
  // |com_service_cmd_line_args| indicates switches that the SCM needs to pass
  // to ServiceMain() during COM activation. This is used to distinguish a
  // non-COM SCM activation (for example, an AUTO start, or when someone
  // manually starts the service using the control panel) from a COM service
  // activation. For example, "comsvc" could be a switch used to indicate a COM
  // activation.
  //
  // NOTE: |registry_path| is mapped to the 32-bit view of the registry for
  // legacy reasons. |registry_path| is the path in HKEY_LOCAL_MACHINE under
  // which the service persists information, for instance if the service has to
  // persist a versioned service name. An example |registry_path| is
  // "Software\ProductFoo".
  //
  // If COM CLSID/AppId registration is required, |clsids| should contain the
  // CLSIDs and AppIds to register. If COM Interface/Typelib registration is
  // required, |iids| should contain the Interfaces and Typelibs to register.
  InstallServiceWorkItem(const std::wstring& service_name,
                         const std::wstring& display_name,
                         const std::wstring& description,
                         uint32_t start_type,
                         const base::CommandLine& service_cmd_line,
                         const base::CommandLine& com_service_cmd_line_args,
                         const std::wstring& registry_path,
                         const std::vector<GUID>& clsids,
                         const std::vector<GUID>& iids);

  InstallServiceWorkItem(const InstallServiceWorkItem&) = delete;
  InstallServiceWorkItem& operator=(const InstallServiceWorkItem&) = delete;

  ~InstallServiceWorkItem() override;

  static bool DeleteService(const std::wstring& service_name,
                            const std::wstring& registry_path,
                            const std::vector<GUID>& clsids,
                            const std::vector<GUID>& iids);

  // Returns true if a cursory check appears to indicate that the service
  // hosting `clsid` is installed.
  static bool IsComServiceInstalled(const GUID& clsid);

  // Returns the current name of the service as registered with the SCM.
  static std::wstring GetCurrentServiceName(base::wcstring_view service_name,
                                            base::wcstring_view registry_path);

 private:
  friend class InstallServiceWorkItemTest;

  // Overrides of WorkItem.
  bool DoImpl() override;
  void RollbackImpl() override;

  std::unique_ptr<InstallServiceWorkItemImpl> impl_;
};

}  // namespace installer

#endif  // CHROME_INSTALLER_UTIL_INSTALL_SERVICE_WORK_ITEM_H_