1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
// 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_
|
