// Copyright 2012 The Chromium Authors // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include "base/win/registry.h" #include #include #include #include #include #include #include #include "base/check_op.h" #include "base/containers/fixed_flat_map.h" #include "base/functional/callback.h" #include "base/native_library.h" #include "base/notreached.h" #include "base/strings/string_piece.h" #include "base/strings/string_util.h" #include "base/strings/string_util_win.h" #include "base/threading/thread_restrictions.h" #include "base/win/object_watcher.h" #include "base/win/pe_image.h" #include "base/win/scoped_handle.h" #include "base/win/shlwapi.h" namespace base::win { namespace { // RegEnumValue() reports the number of characters from the name that were // written to the buffer, not how many there are. This constant is the maximum // name size, such that a buffer with this size should read any name. constexpr DWORD MAX_REGISTRY_NAME_SIZE = 16384; // Registry values are read as BYTE* but can have wchar_t* data whose last // wchar_t is truncated. This function converts the reported |byte_size| to // a size in wchar_t that can store a truncated wchar_t if necessary. inline DWORD to_wchar_size(DWORD byte_size) { return (byte_size + sizeof(wchar_t) - 1) / sizeof(wchar_t); } // Mask to pull WOW64 access flags out of REGSAM access. constexpr REGSAM kWow64AccessMask = KEY_WOW64_32KEY | KEY_WOW64_64KEY; constexpr DWORD kInvalidIterValue = static_cast(-1); } // namespace namespace internal { // A forwarder to the normal delayloaded Windows Registry API. class Standard { public: static inline LSTATUS CreateKey(HKEY hKey, LPCWSTR lpSubKey, DWORD Reserved, LPWSTR lpClass, DWORD dwOptions, REGSAM samDesired, CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes, PHKEY phkResult, LPDWORD lpdwDisposition) { return ::RegCreateKeyExW(hKey, lpSubKey, Reserved, lpClass, dwOptions, samDesired, lpSecurityAttributes, phkResult, lpdwDisposition); } static inline LSTATUS OpenKey(HKEY hKey, LPCWSTR lpSubKey, DWORD ulOptions, REGSAM samDesired, PHKEY phkResult) { return ::RegOpenKeyExW(hKey, lpSubKey, ulOptions, samDesired, phkResult); } static inline LSTATUS DeleteKey(HKEY hKey, LPCWSTR lpSubKey, REGSAM samDesired, DWORD Reserved) { return ::RegDeleteKeyExW(hKey, lpSubKey, samDesired, Reserved); } static inline LSTATUS QueryInfoKey(HKEY hKey, LPWSTR lpClass, LPDWORD lpcchClass, LPDWORD lpReserved, LPDWORD lpcSubKeys, LPDWORD lpcbMaxSubKeyLen, LPDWORD lpcbMaxClassLen, LPDWORD lpcValues, LPDWORD lpcbMaxValueNameLen, LPDWORD lpcbMaxValueLen, LPDWORD lpcbSecurityDescriptor, PFILETIME lpftLastWriteTime) { return ::RegQueryInfoKeyW(hKey, lpClass, lpcchClass, lpReserved, lpcSubKeys, lpcbMaxSubKeyLen, lpcbMaxClassLen, lpcValues, lpcbMaxValueNameLen, lpcbMaxValueLen, lpcbSecurityDescriptor, lpftLastWriteTime); } static inline LSTATUS EnumKey(HKEY hKey, DWORD dwIndex, LPWSTR lpName, LPDWORD lpcchName, LPDWORD lpReserved, LPWSTR lpClass, LPDWORD lpcchClass, PFILETIME lpftLastWriteTime) { return ::RegEnumKeyExW(hKey, dwIndex, lpName, lpcchName, lpReserved, lpClass, lpcchClass, lpftLastWriteTime); } static inline LSTATUS CloseKey(HKEY hKey) { return ::RegCloseKey(hKey); } static inline LSTATUS QueryValue(HKEY hKey, LPCWSTR lpValueName, LPDWORD lpReserved, LPDWORD lpType, LPBYTE lpData, LPDWORD lpcbData) { return ::RegQueryValueExW(hKey, lpValueName, lpReserved, lpType, lpData, lpcbData); } static inline LSTATUS SetValue(HKEY hKey, LPCWSTR lpValueName, DWORD Reserved, DWORD dwType, CONST BYTE* lpData, DWORD cbData) { return ::RegSetValueExW(hKey, lpValueName, Reserved, dwType, lpData, cbData); } static inline LSTATUS DeleteValue(HKEY hKey, LPCWSTR lpValueName) { return ::RegDeleteValueW(hKey, lpValueName); } static inline LSTATUS EnumValue(HKEY hKey, DWORD dwIndex, LPWSTR lpValueName, LPDWORD lpcchValueName, LPDWORD lpReserved, LPDWORD lpType, LPBYTE lpData, LPDWORD lpcbData) { return ::RegEnumValueW(hKey, dwIndex, lpValueName, lpcchValueName, lpReserved, lpType, lpData, lpcbData); } }; // An implementation derived from the export table of advapi32. class ExportDerived { public: static LSTATUS CreateKey(HKEY hKey, LPCWSTR lpSubKey, DWORD Reserved, LPWSTR lpClass, DWORD dwOptions, REGSAM samDesired, CONST LPSECURITY_ATTRIBUTES lpSecurityAttributes, PHKEY phkResult, LPDWORD lpdwDisposition) { if (!ResolveRegistryFunctions() || !reg_create_key_ex_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_create_key_ex_(hKey, lpSubKey, Reserved, lpClass, dwOptions, samDesired, lpSecurityAttributes, phkResult, lpdwDisposition); } static LSTATUS OpenKey(HKEY hKey, LPCWSTR lpSubKey, DWORD ulOptions, REGSAM samDesired, PHKEY phkResult) { if (!ResolveRegistryFunctions() || !reg_open_key_ex_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_open_key_ex_(hKey, lpSubKey, ulOptions, samDesired, phkResult); } static LSTATUS DeleteKey(HKEY hKey, LPCWSTR lpSubKey, REGSAM samDesired, DWORD Reserved) { if (!ResolveRegistryFunctions() || !reg_delete_key_ex_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_delete_key_ex_(hKey, lpSubKey, samDesired, Reserved); } static LSTATUS QueryInfoKey(HKEY hKey, LPWSTR lpClass, LPDWORD lpcchClass, LPDWORD lpReserved, LPDWORD lpcSubKeys, LPDWORD lpcbMaxSubKeyLen, LPDWORD lpcbMaxClassLen, LPDWORD lpcValues, LPDWORD lpcbMaxValueNameLen, LPDWORD lpcbMaxValueLen, LPDWORD lpcbSecurityDescriptor, PFILETIME lpftLastWriteTime) { if (!ResolveRegistryFunctions() || !reg_query_info_key_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_query_info_key_(hKey, lpClass, lpcchClass, lpReserved, lpcSubKeys, lpcbMaxSubKeyLen, lpcbMaxClassLen, lpcValues, lpcbMaxValueNameLen, lpcbMaxValueLen, lpcbSecurityDescriptor, lpftLastWriteTime); } static LSTATUS EnumKey(HKEY hKey, DWORD dwIndex, LPWSTR lpName, LPDWORD lpcchName, LPDWORD lpReserved, LPWSTR lpClass, LPDWORD lpcchClass, PFILETIME lpftLastWriteTime) { if (!ResolveRegistryFunctions() || !reg_enum_key_ex_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_enum_key_ex_(hKey, dwIndex, lpName, lpcchName, lpReserved, lpClass, lpcchClass, lpftLastWriteTime); } static LSTATUS CloseKey(HKEY hKey) { if (!ResolveRegistryFunctions() || !reg_close_key_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_close_key_(hKey); } static LSTATUS QueryValue(HKEY hKey, LPCWSTR lpValueName, LPDWORD lpReserved, LPDWORD lpType, LPBYTE lpData, LPDWORD lpcbData) { if (!ResolveRegistryFunctions() || !reg_query_value_ex_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_query_value_ex_(hKey, lpValueName, lpReserved, lpType, lpData, lpcbData); } static LSTATUS SetValue(HKEY hKey, LPCWSTR lpValueName, DWORD Reserved, DWORD dwType, CONST BYTE* lpData, DWORD cbData) { if (!ResolveRegistryFunctions() || !reg_set_value_ex_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_set_value_ex_(hKey, lpValueName, Reserved, dwType, lpData, cbData); } static LSTATUS DeleteValue(HKEY hKey, LPCWSTR lpValueName) { if (!ResolveRegistryFunctions() || !reg_delete_value_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_delete_value_(hKey, lpValueName); } static LSTATUS EnumValue(HKEY hKey, DWORD dwIndex, LPWSTR lpValueName, LPDWORD lpcchValueName, LPDWORD lpReserved, LPDWORD lpType, LPBYTE lpData, LPDWORD lpcbData) { if (!ResolveRegistryFunctions() || !reg_enum_value_) { return ERROR_ERRORS_ENCOUNTERED; } return reg_enum_value_(hKey, dwIndex, lpValueName, lpcchValueName, lpReserved, lpType, lpData, lpcbData); } private: static bool ProcessOneExport(const base::win::PEImage& image, DWORD ordinal, DWORD hint, LPCSTR name, PVOID function_addr, LPCSTR forward, PVOID cookie) { if (!name || !function_addr) { return true; } static const auto kMap = base::MakeFixedFlatMapSorted({ {"RegCloseKey", reinterpret_cast(®_close_key_)}, {"RegCreateKeyExW", reinterpret_cast(®_create_key_ex_)}, {"RegDeleteKeyExW", reinterpret_cast(®_delete_key_ex_)}, {"RegDeleteValueW", reinterpret_cast(®_delete_value_)}, {"RegEnumKeyExW", reinterpret_cast(®_enum_key_ex_)}, {"RegEnumValueW", reinterpret_cast(®_enum_value_)}, {"RegOpenKeyExW", reinterpret_cast(®_open_key_ex_)}, {"RegQueryInfoKeyW", reinterpret_cast(®_query_info_key_)}, {"RegQueryValueExW", reinterpret_cast(®_query_value_ex_)}, {"RegSetValueExW", reinterpret_cast(®_set_value_ex_)}, }); auto* entry = kMap.find(name); if (entry == kMap.end()) { return true; } static size_t num_init_functions = 0; if (!std::exchange(*(entry->second), function_addr)) { ++num_init_functions; } bool& fully_resolved = *static_cast(cookie); fully_resolved = num_init_functions == kMap.size(); return !fully_resolved; } static bool ResolveRegistryFunctions() { static bool initialized = []() { base::NativeLibraryLoadError error; HMODULE advapi32 = base::PinSystemLibrary(L"advapi32.dll", &error); if (!advapi32 || error.code) { return false; } bool fully_resolved = false; base::win::PEImage(advapi32).EnumExports(&ProcessOneExport, &fully_resolved); return fully_resolved; }(); return initialized; } static decltype(::RegCreateKeyExW)* reg_create_key_ex_; static decltype(::RegOpenKeyExW)* reg_open_key_ex_; static decltype(::RegDeleteKeyExW)* reg_delete_key_ex_; static decltype(::RegQueryInfoKeyW)* reg_query_info_key_; static decltype(::RegEnumKeyExW)* reg_enum_key_ex_; static decltype(::RegCloseKey)* reg_close_key_; static decltype(::RegQueryValueExW)* reg_query_value_ex_; static decltype(::RegSetValueExW)* reg_set_value_ex_; static decltype(::RegDeleteValueW)* reg_delete_value_; static decltype(::RegEnumValueW)* reg_enum_value_; }; decltype(::RegCreateKeyEx)* ExportDerived::reg_create_key_ex_ = nullptr; decltype(::RegOpenKeyExW)* ExportDerived::reg_open_key_ex_ = nullptr; decltype(::RegDeleteKeyExW)* ExportDerived::reg_delete_key_ex_ = nullptr; decltype(::RegQueryInfoKeyW)* ExportDerived::reg_query_info_key_ = nullptr; decltype(::RegEnumKeyExW)* ExportDerived::reg_enum_key_ex_ = nullptr; decltype(::RegCloseKey)* ExportDerived::reg_close_key_ = nullptr; decltype(::RegQueryValueEx)* ExportDerived::reg_query_value_ex_ = nullptr; decltype(::RegSetValueExW)* ExportDerived::reg_set_value_ex_ = nullptr; decltype(::RegDeleteValueW)* ExportDerived::reg_delete_value_ = nullptr; decltype(::RegEnumValueW)* ExportDerived::reg_enum_value_ = nullptr; // Watches for modifications to a key. template class GenericRegKey::Watcher : public ObjectWatcher::Delegate { public: Watcher() = default; Watcher(const Watcher&) = delete; Watcher& operator=(const Watcher&) = delete; ~Watcher() override = default; bool StartWatching(HKEY key, ChangeCallback callback); // ObjectWatcher::Delegate: void OnObjectSignaled(HANDLE object) override { DCHECK(watch_event_.is_valid()); DCHECK_EQ(watch_event_.get(), object); std::move(callback_).Run(); } private: ScopedHandle watch_event_; ObjectWatcher object_watcher_; ChangeCallback callback_; }; template bool GenericRegKey::Watcher::StartWatching(HKEY key, ChangeCallback callback) { DCHECK(key); DCHECK(callback_.is_null()); if (!watch_event_.is_valid()) { watch_event_.Set(CreateEvent(nullptr, TRUE, FALSE, nullptr)); } if (!watch_event_.is_valid()) { return false; } DWORD filter = REG_NOTIFY_CHANGE_NAME | REG_NOTIFY_CHANGE_ATTRIBUTES | REG_NOTIFY_CHANGE_LAST_SET | REG_NOTIFY_CHANGE_SECURITY | REG_NOTIFY_THREAD_AGNOSTIC; // Watch the registry key for a change of value. LONG result = RegNotifyChangeKeyValue(key, /*bWatchSubtree=*/TRUE, filter, watch_event_.get(), /*fAsynchronous=*/TRUE); if (result != ERROR_SUCCESS) { watch_event_.Close(); return false; } callback_ = std::move(callback); return object_watcher_.StartWatchingOnce(watch_event_.get(), this); } // GenericRegKey // ---------------------------------------------------------------------- template GenericRegKey::GenericRegKey() = default; template GenericRegKey::GenericRegKey(HKEY key) : key_(key) {} template GenericRegKey::GenericRegKey(HKEY rootkey, const wchar_t* subkey, REGSAM access) { if (rootkey) { if (access & (KEY_SET_VALUE | KEY_CREATE_SUB_KEY | KEY_CREATE_LINK)) { Create(rootkey, subkey, access); } else { Open(rootkey, subkey, access); } } else { DCHECK(!subkey); wow64access_ = access & kWow64AccessMask; } } template GenericRegKey::GenericRegKey(GenericRegKey&& other) noexcept : key_(other.key_), wow64access_(other.wow64access_), key_watcher_(std::move(other.key_watcher_)) { other.key_ = nullptr; other.wow64access_ = 0; } template GenericRegKey& GenericRegKey::operator=(GenericRegKey&& other) { Close(); std::swap(key_, other.key_); std::swap(wow64access_, other.wow64access_); key_watcher_ = std::move(other.key_watcher_); return *this; } template GenericRegKey::~GenericRegKey() { Close(); } template LONG GenericRegKey::Create(HKEY rootkey, const wchar_t* subkey, REGSAM access) { DWORD disposition_value; return CreateWithDisposition(rootkey, subkey, &disposition_value, access); } template LONG GenericRegKey::CreateWithDisposition(HKEY rootkey, const wchar_t* subkey, DWORD* disposition, REGSAM access) { DCHECK(rootkey && subkey && access && disposition); HKEY subhkey = nullptr; LONG result = Reg::CreateKey(rootkey, subkey, 0, nullptr, REG_OPTION_NON_VOLATILE, access, nullptr, &subhkey, disposition); if (result == ERROR_SUCCESS) { Close(); key_ = subhkey; wow64access_ = access & kWow64AccessMask; } return result; } template LONG GenericRegKey::CreateKey(const wchar_t* name, REGSAM access) { DCHECK(name && access); // After the application has accessed an alternate registry view using one // of the [KEY_WOW64_32KEY / KEY_WOW64_64KEY] flags, all subsequent // operations (create, delete, or open) on child registry keys must // explicitly use the same flag. Otherwise, there can be unexpected // behavior. // http://msdn.microsoft.com/en-us/library/windows/desktop/aa384129.aspx. if ((access & kWow64AccessMask) != wow64access_) { NOTREACHED(); return ERROR_INVALID_PARAMETER; } HKEY subkey = nullptr; LONG result = Reg::CreateKey(key_, name, 0, nullptr, REG_OPTION_NON_VOLATILE, access, nullptr, &subkey, nullptr); if (result == ERROR_SUCCESS) { Close(); key_ = subkey; wow64access_ = access & kWow64AccessMask; } return result; } template LONG GenericRegKey::Open(HKEY rootkey, const wchar_t* subkey, REGSAM access) { DCHECK(rootkey && subkey && access); HKEY subhkey = nullptr; LONG result = Reg::OpenKey(rootkey, subkey, 0, access, &subhkey); if (result == ERROR_SUCCESS) { Close(); key_ = subhkey; wow64access_ = access & kWow64AccessMask; } return result; } template LONG GenericRegKey::OpenKey(const wchar_t* relative_key_name, REGSAM access) { DCHECK(relative_key_name && access); // After the application has accessed an alternate registry view using one // of the [KEY_WOW64_32KEY / KEY_WOW64_64KEY] flags, all subsequent // operations (create, delete, or open) on child registry keys must // explicitly use the same flag. Otherwise, there can be unexpected // behavior. // http://msdn.microsoft.com/en-us/library/windows/desktop/aa384129.aspx. if ((access & kWow64AccessMask) != wow64access_) { NOTREACHED(); return ERROR_INVALID_PARAMETER; } HKEY subkey = nullptr; LONG result = Reg::OpenKey(key_, relative_key_name, 0, access, &subkey); // We have to close the current opened key before replacing it with the new // one. if (result == ERROR_SUCCESS) { Close(); key_ = subkey; wow64access_ = access & kWow64AccessMask; } return result; } template void GenericRegKey::Close() { if (key_) { Reg::CloseKey(key_); key_ = nullptr; wow64access_ = 0; } } // TODO(wfh): Remove this and other unsafe methods. See // http://crbug.com/375400 template void GenericRegKey::Set(HKEY key) { if (key_ != key) { Close(); key_ = key; } } template HKEY GenericRegKey::Take() { DCHECK_EQ(wow64access_, 0u); HKEY key = key_; key_ = nullptr; return key; } template bool GenericRegKey::HasValue(const wchar_t* name) const { return Reg::QueryValue(key_, name, nullptr, nullptr, nullptr, nullptr) == ERROR_SUCCESS; } template DWORD GenericRegKey::GetValueCount() const { DWORD count = 0; LONG result = Reg::QueryInfoKey(key_, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, &count, nullptr, nullptr, nullptr, nullptr); return (result == ERROR_SUCCESS) ? count : 0; } template FILETIME GenericRegKey::GetLastWriteTime() const { FILETIME last_write_time; LONG result = Reg::QueryInfoKey(key_, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, &last_write_time); return (result == ERROR_SUCCESS) ? last_write_time : FILETIME{}; } template LONG GenericRegKey::GetValueNameAt(DWORD index, std::wstring* name) const { wchar_t buf[256]; DWORD bufsize = std::size(buf); LONG r = Reg::EnumValue(key_, index, buf, &bufsize, nullptr, nullptr, nullptr, nullptr); if (r == ERROR_SUCCESS) { name->assign(buf, bufsize); } return r; } template LONG GenericRegKey::DeleteKey(const wchar_t* name) { DCHECK(name); // Verify the key exists before attempting delete to replicate previous // behavior. // `RegOpenKeyEx()` will return an error if `key_` is invalid. HKEY subkey = nullptr; LONG result = Reg::OpenKey(key_, name, 0, READ_CONTROL | wow64access_, &subkey); if (result != ERROR_SUCCESS) { return result; } Reg::CloseKey(subkey); return RegDelRecurse(key_, name, wow64access_); } template LONG GenericRegKey::DeleteEmptyKey(const wchar_t* name) { DCHECK(name); // `RegOpenKeyEx()` will return an error if `key_` is invalid. HKEY target_key = nullptr; LONG result = Reg::OpenKey(key_, name, 0, KEY_READ | wow64access_, &target_key); if (result != ERROR_SUCCESS) { return result; } DWORD count = 0; result = Reg::QueryInfoKey(target_key, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, &count, nullptr, nullptr, nullptr, nullptr); Reg::CloseKey(target_key); if (result != ERROR_SUCCESS) { return result; } if (count == 0) { return RegDeleteKeyEx(key_, name, wow64access_, 0); } return ERROR_DIR_NOT_EMPTY; } template LONG GenericRegKey::DeleteValue(const wchar_t* value_name) { // `RegDeleteValue()` will return an error if `key_` is invalid. LONG result = Reg::DeleteValue(key_, value_name); return result; } template LONG GenericRegKey::ReadValueDW(const wchar_t* name, DWORD* out_value) const { DCHECK(out_value); DWORD type = REG_DWORD; DWORD size = sizeof(DWORD); DWORD local_value = 0; LONG result = ReadValue(name, &local_value, &size, &type); if (result == ERROR_SUCCESS) { if ((type == REG_DWORD || type == REG_BINARY) && size == sizeof(DWORD)) { *out_value = local_value; } else { result = ERROR_CANTREAD; } } return result; } template LONG GenericRegKey::ReadInt64(const wchar_t* name, int64_t* out_value) const { DCHECK(out_value); DWORD type = REG_QWORD; int64_t local_value = 0; DWORD size = sizeof(local_value); LONG result = ReadValue(name, &local_value, &size, &type); if (result == ERROR_SUCCESS) { if ((type == REG_QWORD || type == REG_BINARY) && size == sizeof(local_value)) { *out_value = local_value; } else { result = ERROR_CANTREAD; } } return result; } template LONG GenericRegKey::ReadValue(const wchar_t* name, std::wstring* out_value) const { DCHECK(out_value); const size_t kMaxStringLength = 1024; // This is after expansion. // Use the one of the other forms of ReadValue if 1024 is too small for you. wchar_t raw_value[kMaxStringLength]; DWORD type = REG_SZ, size = sizeof(raw_value); LONG result = ReadValue(name, raw_value, &size, &type); if (result == ERROR_SUCCESS) { if (type == REG_SZ) { *out_value = raw_value; } else if (type == REG_EXPAND_SZ) { wchar_t expanded[kMaxStringLength]; size = ExpandEnvironmentStrings(raw_value, expanded, kMaxStringLength); // Success: returns the number of wchar_t's copied // Fail: buffer too small, returns the size required // Fail: other, returns 0 if (size == 0 || size > kMaxStringLength) { result = ERROR_MORE_DATA; } else { *out_value = expanded; } } else { // Not a string. Oops. result = ERROR_CANTREAD; } } return result; } template LONG GenericRegKey::ReadValue(const wchar_t* name, void* data, DWORD* dsize, DWORD* dtype) const { LONG result = Reg::QueryValue(key_, name, nullptr, dtype, reinterpret_cast(data), dsize); return result; } template LONG GenericRegKey::ReadValues(const wchar_t* name, std::vector* values) { values->clear(); DWORD type = REG_MULTI_SZ; DWORD size = 0; LONG result = ReadValue(name, nullptr, &size, &type); if (result != ERROR_SUCCESS || size == 0) { return result; } if (type != REG_MULTI_SZ) { return ERROR_CANTREAD; } std::vector buffer(size / sizeof(wchar_t)); result = ReadValue(name, buffer.data(), &size, nullptr); if (result != ERROR_SUCCESS || size == 0) { return result; } // Parse the double-null-terminated list of strings. // Note: This code is paranoid to not read outside of |buf|, in the case // where it may not be properly terminated. auto entry = buffer.cbegin(); auto buffer_end = buffer.cend(); while (entry < buffer_end && *entry != '\0') { auto entry_end = std::find(entry, buffer_end, '\0'); values->emplace_back(entry, entry_end); entry = entry_end + 1; } return 0; } template LONG GenericRegKey::WriteValue(const wchar_t* name, DWORD in_value) { return WriteValue(name, &in_value, static_cast(sizeof(in_value)), REG_DWORD); } template LONG GenericRegKey::WriteValue(const wchar_t* name, const wchar_t* in_value) { return WriteValue( name, in_value, static_cast(sizeof(*in_value) * (std::char_traits::length(in_value) + 1)), REG_SZ); } template LONG GenericRegKey::WriteValue(const wchar_t* name, const void* data, DWORD dsize, DWORD dtype) { DCHECK(data || !dsize); LONG result = Reg::SetValue(key_, name, 0, dtype, reinterpret_cast(const_cast(data)), dsize); return result; } template bool GenericRegKey::StartWatching(ChangeCallback callback) { if (!key_watcher_) { key_watcher_ = std::make_unique(); } if (!key_watcher_->StartWatching(key_, std::move(callback))) { return false; } return true; } // static template LONG GenericRegKey::RegDelRecurse(HKEY root_key, const wchar_t* name, REGSAM access) { // First, see if the key can be deleted without having to recurse. LONG result = Reg::DeleteKey(root_key, name, access, 0); if (result == ERROR_SUCCESS) { return result; } HKEY target_key = nullptr; result = Reg::OpenKey(root_key, name, 0, KEY_ENUMERATE_SUB_KEYS | access, &target_key); if (result == ERROR_FILE_NOT_FOUND) { return ERROR_SUCCESS; } if (result != ERROR_SUCCESS) return result; std::wstring subkey_name(name); // Check for an ending slash and add one if it is missing. if (!subkey_name.empty() && subkey_name.back() != '\\') { subkey_name.push_back('\\'); } // Enumerate the keys result = ERROR_SUCCESS; const DWORD kMaxKeyNameLength = MAX_PATH; const size_t base_key_length = subkey_name.length(); std::wstring key_name; while (result == ERROR_SUCCESS) { DWORD key_size = kMaxKeyNameLength; result = Reg::EnumKey(target_key, 0, WriteInto(&key_name, kMaxKeyNameLength), &key_size, nullptr, nullptr, nullptr, nullptr); if (result != ERROR_SUCCESS) { break; } key_name.resize(key_size); subkey_name.resize(base_key_length); subkey_name += key_name; if (RegDelRecurse(root_key, subkey_name.c_str(), access) != ERROR_SUCCESS) { break; } } Reg::CloseKey(target_key); // Try again to delete the key. result = Reg::DeleteKey(root_key, name, access, 0); return result; } // Instantiate the only two allowed versions of GenericRegKey for use by the // public base::win::RegKey and base::win::ExportDerivedRegKey. template class GenericRegKey; template class GenericRegKey; } // namespace internal RegKey::RegKey() : GenericRegKey() {} RegKey::RegKey(HKEY key) : GenericRegKey(key) {} RegKey::RegKey(HKEY rootkey, const wchar_t* subkey, REGSAM access) : GenericRegKey(rootkey, subkey, access) {} RegKey::RegKey(RegKey&& other) noexcept : GenericRegKey(std::move(other)) {} RegKey& RegKey::operator=(RegKey&& other) { GenericRegKey::operator=(std::move(other)); return *this; } RegKey::~RegKey() = default; ExportDerivedRegKey::ExportDerivedRegKey() : GenericRegKey() {} ExportDerivedRegKey::ExportDerivedRegKey(HKEY key) : GenericRegKey(key) {} ExportDerivedRegKey::ExportDerivedRegKey(HKEY rootkey, const wchar_t* subkey, REGSAM access) : GenericRegKey(rootkey, subkey, access) {} ExportDerivedRegKey::ExportDerivedRegKey(ExportDerivedRegKey&& other) noexcept : GenericRegKey(std::move(other)) {} ExportDerivedRegKey& ExportDerivedRegKey::operator=( ExportDerivedRegKey&& other) { GenericRegKey::operator=(std::move(other)); return *this; } ExportDerivedRegKey::~ExportDerivedRegKey() = default; // RegistryValueIterator ------------------------------------------------------ RegistryValueIterator::RegistryValueIterator(HKEY root_key, const wchar_t* folder_key, REGSAM wow64access) : name_(MAX_PATH, '\0'), value_(MAX_PATH, '\0') { Initialize(root_key, folder_key, wow64access); } RegistryValueIterator::RegistryValueIterator(HKEY root_key, const wchar_t* folder_key) : name_(MAX_PATH, '\0'), value_(MAX_PATH, '\0') { Initialize(root_key, folder_key, 0); } void RegistryValueIterator::Initialize(HKEY root_key, const wchar_t* folder_key, REGSAM wow64access) { DCHECK_EQ(wow64access & ~kWow64AccessMask, static_cast(0)); LONG result = RegOpenKeyEx(root_key, folder_key, 0, KEY_READ | wow64access, &key_); if (result != ERROR_SUCCESS) { key_ = nullptr; } else { DWORD count = 0; result = ::RegQueryInfoKey(key_, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, &count, nullptr, nullptr, nullptr, nullptr); if (result != ERROR_SUCCESS) { ::RegCloseKey(key_); key_ = nullptr; } else { index_ = count - 1; } } Read(); } RegistryValueIterator::~RegistryValueIterator() { if (key_) ::RegCloseKey(key_); } DWORD RegistryValueIterator::ValueCount() const { DWORD count = 0; LONG result = ::RegQueryInfoKey(key_, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, &count, nullptr, nullptr, nullptr, nullptr); if (result != ERROR_SUCCESS) return 0; return count; } bool RegistryValueIterator::Valid() const { return key_ != nullptr && index_ != kInvalidIterValue; } void RegistryValueIterator::operator++() { if (index_ != kInvalidIterValue) --index_; Read(); } bool RegistryValueIterator::Read() { if (Valid()) { DWORD capacity = static_cast(name_.capacity()); DWORD name_size = capacity; // |value_size_| is in bytes. Reserve the last character for a NUL. value_size_ = static_cast((value_.size() - 1) * sizeof(wchar_t)); LONG result = ::RegEnumValue( key_, index_, WriteInto(&name_, name_size), &name_size, nullptr, &type_, reinterpret_cast(value_.data()), &value_size_); if (result == ERROR_MORE_DATA) { // Registry key names are limited to 255 characters and fit within // MAX_PATH (which is 260) but registry value names can use up to 16,383 // characters and the value itself is not limited // (from http://msdn.microsoft.com/en-us/library/windows/desktop/ // ms724872(v=vs.85).aspx). // Resize the buffers and retry if their size caused the failure. DWORD value_size_in_wchars = to_wchar_size(value_size_); if (value_size_in_wchars + 1 > value_.size()) value_.resize(value_size_in_wchars + 1, '\0'); value_size_ = static_cast((value_.size() - 1) * sizeof(wchar_t)); name_size = name_size == capacity ? MAX_REGISTRY_NAME_SIZE : capacity; result = ::RegEnumValue( key_, index_, WriteInto(&name_, name_size), &name_size, nullptr, &type_, reinterpret_cast(value_.data()), &value_size_); } if (result == ERROR_SUCCESS) { DCHECK_LT(to_wchar_size(value_size_), value_.size()); value_[to_wchar_size(value_size_)] = '\0'; return true; } } name_[0] = '\0'; value_[0] = '\0'; value_size_ = 0; return false; } // RegistryKeyIterator -------------------------------------------------------- RegistryKeyIterator::RegistryKeyIterator(HKEY root_key, const wchar_t* folder_key) { Initialize(root_key, folder_key, 0); } RegistryKeyIterator::RegistryKeyIterator(HKEY root_key, const wchar_t* folder_key, REGSAM wow64access) { Initialize(root_key, folder_key, wow64access); } RegistryKeyIterator::~RegistryKeyIterator() { if (key_) ::RegCloseKey(key_); } DWORD RegistryKeyIterator::SubkeyCount() const { DWORD count = 0; LONG result = ::RegQueryInfoKey(key_, nullptr, nullptr, nullptr, &count, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr); if (result != ERROR_SUCCESS) return 0; return count; } bool RegistryKeyIterator::Valid() const { return key_ != nullptr && index_ != kInvalidIterValue; } void RegistryKeyIterator::operator++() { if (index_ != kInvalidIterValue) --index_; Read(); } bool RegistryKeyIterator::Read() { if (Valid()) { DWORD ncount = static_cast(std::size(name_)); FILETIME written; LONG r = ::RegEnumKeyEx(key_, index_, name_, &ncount, nullptr, nullptr, nullptr, &written); if (ERROR_SUCCESS == r) return true; } name_[0] = '\0'; return false; } void RegistryKeyIterator::Initialize(HKEY root_key, const wchar_t* folder_key, REGSAM wow64access) { DCHECK_EQ(wow64access & ~kWow64AccessMask, static_cast(0)); LONG result = RegOpenKeyEx(root_key, folder_key, 0, KEY_READ | wow64access, &key_); if (result != ERROR_SUCCESS) { key_ = nullptr; } else { DWORD count = 0; result = ::RegQueryInfoKey(key_, nullptr, nullptr, nullptr, &count, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr, nullptr); if (result != ERROR_SUCCESS) { ::RegCloseKey(key_); key_ = nullptr; } else { index_ = count - 1; } } Read(); } } // namespace base::win