OLD | NEW |
| (Empty) |
1 // Copyright 2007-2010 Google Inc. | |
2 // | |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | |
4 // you may not use this file except in compliance with the License. | |
5 // You may obtain a copy of the License at | |
6 // | |
7 // http://www.apache.org/licenses/LICENSE-2.0 | |
8 // | |
9 // Unless required by applicable law or agreed to in writing, software | |
10 // distributed under the License is distributed on an "AS IS" BASIS, | |
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
12 // See the License for the specific language governing permissions and | |
13 // limitations under the License. | |
14 // ======================================================================== | |
15 | |
16 #include "omaha/common/app_registry_utils.h" | |
17 #include "omaha/base/constants.h" | |
18 #include "omaha/base/debug.h" | |
19 #include "omaha/base/logging.h" | |
20 #include "omaha/base/reg_key.h" | |
21 #include "omaha/base/utils.h" | |
22 #include "omaha/common/config_manager.h" | |
23 #include "omaha/common/const_goopdate.h" | |
24 #include "omaha/common/experiment_labels.h" | |
25 | |
26 namespace omaha { | |
27 | |
28 namespace app_registry_utils { | |
29 | |
30 CString GetAppClientsKey(bool is_machine, const CString& app_guid) { | |
31 return AppendRegKeyPath( | |
32 ConfigManager::Instance()->registry_clients(is_machine), | |
33 app_guid); | |
34 } | |
35 | |
36 CString GetAppClientStateKey(bool is_machine, const CString& app_guid) { | |
37 return AppendRegKeyPath( | |
38 ConfigManager::Instance()->registry_client_state(is_machine), | |
39 app_guid); | |
40 } | |
41 | |
42 CString GetAppClientStateMediumKey(bool is_machine, const CString& app_guid) { | |
43 ASSERT1(is_machine); | |
44 UNREFERENCED_PARAMETER(is_machine); | |
45 return AppendRegKeyPath( | |
46 ConfigManager::Instance()->machine_registry_client_state_medium(), | |
47 app_guid); | |
48 } | |
49 | |
50 // The EULA is assumed to be accepted unless eualaccepted=0 in the ClientState | |
51 // key. For machine apps in this case, eulaccepted=1 in ClientStateMedium also | |
52 // indicates acceptance and the value in ClientState is updated. | |
53 bool IsAppEulaAccepted(bool is_machine, | |
54 const CString& app_guid, | |
55 bool require_explicit_acceptance) { | |
56 const CString state_key = GetAppClientStateKey(is_machine, app_guid); | |
57 | |
58 DWORD eula_accepted = 0; | |
59 if (SUCCEEDED(RegKey::GetValue(state_key, | |
60 kRegValueEulaAccepted, | |
61 &eula_accepted))) { | |
62 if (0 != eula_accepted) { | |
63 return true; | |
64 } | |
65 } else { | |
66 if (!require_explicit_acceptance) { | |
67 return true; | |
68 } | |
69 } | |
70 | |
71 if (!is_machine) { | |
72 return false; | |
73 } | |
74 | |
75 eula_accepted = 0; | |
76 if (SUCCEEDED(RegKey::GetValue( | |
77 GetAppClientStateMediumKey(is_machine, app_guid), | |
78 kRegValueEulaAccepted, | |
79 &eula_accepted))) { | |
80 if (0 == eula_accepted) { | |
81 return false; | |
82 } | |
83 } else { | |
84 return false; | |
85 } | |
86 | |
87 VERIFY1(SUCCEEDED(RegKey::SetValue(state_key, | |
88 kRegValueEulaAccepted, | |
89 eula_accepted))); | |
90 return true; | |
91 } | |
92 | |
93 // Does not need to set ClientStateMedium. | |
94 HRESULT SetAppEulaNotAccepted(bool is_machine, const CString& app_guid) { | |
95 return RegKey::SetValue(GetAppClientStateKey(is_machine, app_guid), | |
96 kRegValueEulaAccepted, | |
97 static_cast<DWORD>(0)); | |
98 } | |
99 | |
100 // Deletes eulaaccepted from ClientState and ClientStateMedium. | |
101 HRESULT ClearAppEulaNotAccepted(bool is_machine, const CString& app_guid) { | |
102 const CString state_key = GetAppClientStateKey(is_machine, app_guid); | |
103 if (RegKey::HasKey(state_key)) { | |
104 HRESULT hr = RegKey::DeleteValue(state_key, kRegValueEulaAccepted); | |
105 if (FAILED(hr)) { | |
106 return hr; | |
107 } | |
108 } | |
109 | |
110 if (!is_machine) { | |
111 return S_OK; | |
112 } | |
113 | |
114 const CString state_medium_key = | |
115 GetAppClientStateMediumKey(is_machine, app_guid); | |
116 if (RegKey::HasKey(state_medium_key)) { | |
117 HRESULT hr = RegKey::DeleteValue(state_medium_key, kRegValueEulaAccepted); | |
118 if (FAILED(hr)) { | |
119 return hr; | |
120 } | |
121 } | |
122 | |
123 return S_OK; | |
124 } | |
125 | |
126 // For machine apps, ClientStateMedium takes precedence. | |
127 // Does not propogate the ClientStateMedium value to ClientState. | |
128 bool AreAppUsageStatsEnabled(bool is_machine, const CString& app_guid) { | |
129 if (is_machine) { | |
130 DWORD stats_enabled = 0; | |
131 if (SUCCEEDED(RegKey::GetValue(GetAppClientStateMediumKey(is_machine, | |
132 app_guid), | |
133 kRegValueUsageStats, | |
134 &stats_enabled))) { | |
135 return (TRISTATE_TRUE == stats_enabled); | |
136 } | |
137 } | |
138 | |
139 DWORD stats_enabled = 0; | |
140 if (SUCCEEDED(RegKey::GetValue(GetAppClientStateKey(is_machine, app_guid), | |
141 kRegValueUsageStats, | |
142 &stats_enabled))) { | |
143 return (TRISTATE_TRUE == stats_enabled); | |
144 } | |
145 | |
146 return false; | |
147 } | |
148 | |
149 // Does nothing if usage_stats_enable is TRISTATE_NONE. | |
150 // For machine apps, clears ClientStateMedium because the app may be reading it | |
151 // if present. | |
152 HRESULT SetUsageStatsEnable(bool is_machine, | |
153 const CString& app_guid, | |
154 Tristate usage_stats_enable) { | |
155 if (TRISTATE_NONE == usage_stats_enable) { | |
156 return S_OK; | |
157 } | |
158 | |
159 const DWORD stats_enabled = (TRISTATE_TRUE == usage_stats_enable) ? 1 : 0; | |
160 | |
161 HRESULT hr = RegKey::SetValue(GetAppClientStateKey(is_machine, app_guid), | |
162 kRegValueUsageStats, | |
163 stats_enabled); | |
164 if (FAILED(hr)) { | |
165 CORE_LOG(LW, (_T("[Failed to set usagestats][0x%08x]"), hr)); | |
166 return hr; | |
167 } | |
168 | |
169 if (!is_machine) { | |
170 return S_OK; | |
171 } | |
172 | |
173 const CString state_medium_key = | |
174 GetAppClientStateMediumKey(is_machine, app_guid); | |
175 if (RegKey::HasKey(state_medium_key)) { | |
176 hr = RegKey::DeleteValue(state_medium_key, kRegValueUsageStats); | |
177 if (FAILED(hr)) { | |
178 return hr; | |
179 } | |
180 } | |
181 | |
182 return S_OK; | |
183 } | |
184 | |
185 // Google Update does not have a referral_id. Everything else is the same as for | |
186 // apps. | |
187 HRESULT SetGoogleUpdateBranding(const CString& client_state_key_path, | |
188 const CString& brand_code, | |
189 const CString& client_id) { | |
190 HRESULT hr(SetAppBranding(client_state_key_path, | |
191 brand_code, | |
192 client_id, | |
193 CString())); | |
194 | |
195 if (FAILED(hr)) { | |
196 return hr; | |
197 } | |
198 | |
199 RegKey state_key; | |
200 hr = state_key.Open(client_state_key_path); | |
201 if (FAILED(hr)) { | |
202 return hr; | |
203 } | |
204 | |
205 // Legacy support for older versions that do not write the FirstInstallTime. | |
206 // This code ensures that FirstInstallTime always has a valid non-zero value. | |
207 DWORD install_time(0); | |
208 if (FAILED(state_key.GetValue(kRegValueInstallTimeSec, &install_time)) || | |
209 !install_time) { | |
210 const DWORD now = Time64ToInt32(GetCurrent100NSTime()); | |
211 VERIFY1(SUCCEEDED(state_key.SetValue(kRegValueInstallTimeSec, now))); | |
212 CORE_LOG(L3, (_T("[InstallTime missing. Setting it here.][%u]"), now)); | |
213 } | |
214 | |
215 return S_OK; | |
216 } | |
217 | |
218 // Branding information is only written if a brand code is not already present. | |
219 // We should only write it if this is the first install of Omaha to avoid giving | |
220 // undue credit to a later installer source. Writing a default brand code | |
221 // prevents future branded installations from setting their brand. | |
222 // As suggested by PSO, there is no default client ID. | |
223 // Assumes the specified Client State key has been created. | |
224 HRESULT SetAppBranding(const CString& client_state_key_path, | |
225 const CString& brand_code, | |
226 const CString& client_id, | |
227 const CString& referral_id) { | |
228 CORE_LOG(L3, (_T("[app_registry_utils::SetAppBranding][%s][%s][%s][%s]"), | |
229 client_state_key_path, brand_code, client_id, referral_id)); | |
230 | |
231 if (brand_code.GetLength() > kBrandIdLength) { | |
232 return E_INVALIDARG; | |
233 } | |
234 | |
235 RegKey state_key; | |
236 HRESULT hr = state_key.Create(client_state_key_path); | |
237 if (FAILED(hr)) { | |
238 return hr; | |
239 } | |
240 | |
241 CString existing_brand_code; | |
242 hr = state_key.GetValue(kRegValueBrandCode, &existing_brand_code); | |
243 if (!existing_brand_code.IsEmpty()) { | |
244 ASSERT1(SUCCEEDED(hr)); | |
245 if (existing_brand_code.GetLength() > kBrandIdLength) { | |
246 // Bug 1358852: Brand code garbled with one click. | |
247 VERIFY1(SUCCEEDED(state_key.SetValue(kRegValueBrandCode, | |
248 existing_brand_code.Left(kBrandIdLength)))); | |
249 } | |
250 return S_OK; | |
251 } | |
252 | |
253 const TCHAR* brand_code_to_write = brand_code.IsEmpty() ? | |
254 kDefaultGoogleUpdateBrandCode : | |
255 brand_code; | |
256 hr = state_key.SetValue(kRegValueBrandCode, brand_code_to_write); | |
257 if (FAILED(hr)) { | |
258 return hr; | |
259 } | |
260 | |
261 if (!client_id.IsEmpty()) { | |
262 hr = state_key.SetValue(kRegValueClientId, client_id); | |
263 if (FAILED(hr)) { | |
264 return hr; | |
265 } | |
266 } | |
267 | |
268 if (!referral_id.IsEmpty()) { | |
269 hr = state_key.SetValue(kRegValueReferralId, referral_id); | |
270 if (FAILED(hr)) { | |
271 return hr; | |
272 } | |
273 } | |
274 | |
275 const DWORD now = Time64ToInt32(GetCurrent100NSTime()); | |
276 VERIFY1(SUCCEEDED(state_key.SetValue(kRegValueInstallTimeSec, now))); | |
277 | |
278 return S_OK; | |
279 } | |
280 | |
281 void PersistSuccessfulInstall(const CString& client_state_key_path, | |
282 bool is_update, | |
283 bool is_offline) { | |
284 CORE_LOG(L3, | |
285 (_T("[app_registry_utils::PersistSuccessfulInstall][%s][%d][%d]"), | |
286 client_state_key_path, is_update, is_offline)); | |
287 ASSERT1(!is_update || !is_offline); | |
288 | |
289 ClearUpdateAvailableStats(client_state_key_path); | |
290 | |
291 if (!is_offline) { | |
292 // TODO(omaha): the semantics of this function are confusing in the | |
293 // case of recording a successful update check. Omaha knows | |
294 // precisely when an update check with the server is being made and it | |
295 // can call PersistSuccessfulUpdateCheck without making any other | |
296 // assumptions. | |
297 // | |
298 // Assumes that all updates are online. | |
299 PersistSuccessfulUpdateCheck(client_state_key_path); | |
300 } | |
301 | |
302 if (is_update) { | |
303 const DWORD now = Time64ToInt32(GetCurrent100NSTime()); | |
304 VERIFY1(SUCCEEDED(RegKey::SetValue(client_state_key_path, | |
305 kRegValueLastUpdateTimeSec, | |
306 now))); | |
307 } | |
308 } | |
309 | |
310 void PersistSuccessfulUpdateCheck(const CString& client_state_key_path) { | |
311 CORE_LOG(L3, (_T("[app_registry_utils::PersistSuccessfulUpdateCheck][%s]"), | |
312 client_state_key_path)); | |
313 const DWORD now = Time64ToInt32(GetCurrent100NSTime()); | |
314 VERIFY1(SUCCEEDED(RegKey::SetValue(client_state_key_path, | |
315 kRegValueLastSuccessfulCheckSec, | |
316 now))); | |
317 } | |
318 | |
319 void ClearUpdateAvailableStats(const CString& client_state_key_path) { | |
320 CORE_LOG(L3, (_T("[app_registry_utils::ClearUpdateAvailableStats][%s]"), | |
321 client_state_key_path)); | |
322 | |
323 RegKey state_key; | |
324 HRESULT hr = state_key.Open(client_state_key_path); | |
325 if (FAILED(hr)) { | |
326 return; | |
327 } | |
328 | |
329 VERIFY1(SUCCEEDED(state_key.DeleteValue(kRegValueUpdateAvailableCount))); | |
330 VERIFY1(SUCCEEDED(state_key.DeleteValue(kRegValueUpdateAvailableSince))); | |
331 } | |
332 | |
333 HRESULT GetNumClients(bool is_machine, size_t* num_clients) { | |
334 ASSERT1(num_clients); | |
335 RegKey reg_key; | |
336 HKEY root_key = is_machine ? HKEY_LOCAL_MACHINE : HKEY_CURRENT_USER; | |
337 HRESULT hr = reg_key.Open(root_key, GOOPDATE_REG_RELATIVE_CLIENTS, KEY_READ); | |
338 if (FAILED(hr)) { | |
339 return hr; | |
340 } | |
341 DWORD num_subkeys(0); | |
342 LONG error = ::RegQueryInfoKey(reg_key.Key(), NULL, NULL, NULL, &num_subkeys, | |
343 NULL, NULL, NULL, NULL, NULL, NULL, NULL); | |
344 if (error != ERROR_SUCCESS) { | |
345 return HRESULT_FROM_WIN32(error); | |
346 } | |
347 *num_clients = num_subkeys; | |
348 return S_OK; | |
349 } | |
350 | |
351 // Reads pv value from Clients key. | |
352 void GetAppVersion(bool is_machine, const CString& app_id, CString* pv) { | |
353 ASSERT1(pv); | |
354 RegKey key; | |
355 CString key_name = GetAppClientsKey(is_machine, app_id); | |
356 HRESULT hr = key.Open(key_name, KEY_READ); | |
357 if (SUCCEEDED(hr)) { | |
358 key.GetValue(kRegValueProductVersion, pv); | |
359 } | |
360 } | |
361 | |
362 // Reads the following values from the registry: | |
363 // ClientState key | |
364 // pv | |
365 // ap | |
366 // lang | |
367 // brand | |
368 // client | |
369 // iid | |
370 // experiment | |
371 void GetClientStateData(bool is_machine, | |
372 const CString& app_id, | |
373 CString* pv, | |
374 CString* ap, | |
375 CString* lang, | |
376 CString* brand_code, | |
377 CString* client_id, | |
378 CString* iid, | |
379 CString* experiment_labels) { | |
380 RegKey key; | |
381 | |
382 CString key_name = GetAppClientStateKey(is_machine, app_id); | |
383 HRESULT hr = key.Open(key_name, KEY_READ); | |
384 if (FAILED(hr)) { | |
385 return; | |
386 } | |
387 | |
388 if (pv) { | |
389 key.GetValue(kRegValueProductVersion, pv); | |
390 } | |
391 if (ap) { | |
392 key.GetValue(kRegValueAdditionalParams, ap); | |
393 } | |
394 if (lang) { | |
395 key.GetValue(kRegValueLanguage, lang); | |
396 } | |
397 if (brand_code) { | |
398 key.GetValue(kRegValueBrandCode, brand_code); | |
399 } | |
400 if (client_id) { | |
401 key.GetValue(kRegValueClientId, client_id); | |
402 } | |
403 if (iid) { | |
404 key.GetValue(kRegValueInstallationId, iid); | |
405 } | |
406 if (experiment_labels) { | |
407 key.GetValue(kRegValueExperimentLabels, experiment_labels); | |
408 } | |
409 } | |
410 | |
411 HRESULT GetUninstalledApps(bool is_machine, | |
412 std::vector<CString>* app_ids) { | |
413 ASSERT1(app_ids); | |
414 | |
415 RegKey client_state_key; | |
416 HRESULT hr = client_state_key.Open( | |
417 ConfigManager::Instance()->registry_client_state(is_machine), | |
418 KEY_READ); | |
419 if (FAILED(hr)) { | |
420 return hr; | |
421 } | |
422 | |
423 int num_sub_keys = client_state_key.GetSubkeyCount(); | |
424 for (int i = 0; i < num_sub_keys; ++i) { | |
425 CString app_id; | |
426 hr = client_state_key.GetSubkeyNameAt(i, &app_id); | |
427 if (FAILED(hr)) { | |
428 continue; | |
429 } | |
430 | |
431 // If the app is not registered, treat it as uninstalled. | |
432 if (!RegKey::HasValue( | |
433 app_registry_utils::GetAppClientsKey(is_machine, app_id), | |
434 kRegValueProductVersion)) { | |
435 app_ids->push_back(app_id); | |
436 } | |
437 } | |
438 | |
439 return S_OK; | |
440 } | |
441 | |
442 HRESULT RemoveClientState(bool is_machine, const CString& app_guid) { | |
443 const CString state_key = GetAppClientStateKey(is_machine, app_guid); | |
444 HRESULT state_hr = RegKey::DeleteKey(state_key, true); | |
445 if (!is_machine) { | |
446 return state_hr; | |
447 } | |
448 | |
449 const CString state_medium_key = GetAppClientStateMediumKey(is_machine, | |
450 app_guid); | |
451 HRESULT state_medium_hr = RegKey::DeleteKey(state_medium_key, true); | |
452 return FAILED(state_hr) ? state_hr : state_medium_hr; | |
453 } | |
454 | |
455 void RemoveClientStateForApps(bool is_machine, | |
456 const std::vector<CString>& apps) { | |
457 std::vector<CString>::const_iterator it; | |
458 for (it = apps.begin(); it != apps.end(); ++it) { | |
459 RemoveClientState(is_machine, *it); | |
460 } | |
461 } | |
462 | |
463 HRESULT GetExperimentLabels(bool is_machine, const CString& app_id, | |
464 CString* labels_out) { | |
465 ASSERT1(!app_id.IsEmpty()); | |
466 ASSERT1(labels_out); | |
467 | |
468 const CString state_key = GetAppClientStateKey(is_machine, app_id); | |
469 if (!RegKey::HasValue(state_key, kRegValueExperimentLabels)) { | |
470 return S_OK; | |
471 } | |
472 | |
473 return RegKey::GetValue(state_key, kRegValueExperimentLabels, labels_out); | |
474 } | |
475 | |
476 HRESULT SetExperimentLabels(bool is_machine, const CString& app_id, | |
477 const CString& new_labels) { | |
478 ASSERT1(!app_id.IsEmpty()); | |
479 ASSERT1(ExperimentLabels::IsStringValidLabelSet(new_labels)); | |
480 | |
481 return RegKey::SetValue(GetAppClientStateKey(is_machine, app_id), | |
482 kRegValueExperimentLabels, | |
483 new_labels); | |
484 } | |
485 | |
486 } // namespace app_registry_utils | |
487 | |
488 } // namespace omaha | |
OLD | NEW |