Index: base/win/registry.h |
diff --git a/base/win/registry.h b/base/win/registry.h |
deleted file mode 100644 |
index c3e015b3bf0e59636e26b9a5a58b4b147df729b1..0000000000000000000000000000000000000000 |
--- a/base/win/registry.h |
+++ /dev/null |
@@ -1,259 +0,0 @@ |
-// 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. |
- |
-#ifndef BASE_WIN_REGISTRY_H_ |
-#define BASE_WIN_REGISTRY_H_ |
- |
-#include <windows.h> |
-#include <string> |
-#include <vector> |
- |
-#include "base/base_export.h" |
-#include "base/basictypes.h" |
-#include "base/stl_util.h" |
-#include "base/win/object_watcher.h" |
-#include "base/win/scoped_handle.h" |
- |
-namespace base { |
-namespace win { |
- |
-// Utility class to read, write and manipulate the Windows Registry. |
-// Registry vocabulary primer: a "key" is like a folder, in which there |
-// are "values", which are <name, data> pairs, with an associated data type. |
-// |
-// Note: |
-// ReadValue family of functions guarantee that the return arguments |
-// are not touched in case of failure. |
-class BASE_EXPORT RegKey { |
- public: |
- // Called from the MessageLoop when the key changes. |
- typedef base::Callback<void()> ChangeCallback; |
- |
- RegKey(); |
- explicit RegKey(HKEY key); |
- RegKey(HKEY rootkey, const wchar_t* subkey, REGSAM access); |
- ~RegKey(); |
- |
- LONG Create(HKEY rootkey, const wchar_t* subkey, REGSAM access); |
- |
- LONG CreateWithDisposition(HKEY rootkey, const wchar_t* subkey, |
- DWORD* disposition, REGSAM access); |
- |
- // Creates a subkey or open it if it already exists. |
- LONG CreateKey(const wchar_t* name, REGSAM access); |
- |
- // Opens an existing reg key. |
- LONG Open(HKEY rootkey, const wchar_t* subkey, REGSAM access); |
- |
- // Opens an existing reg key, given the relative key name. |
- LONG OpenKey(const wchar_t* relative_key_name, REGSAM access); |
- |
- // Closes this reg key. |
- void Close(); |
- |
- // Replaces the handle of the registry key and takes ownership of the handle. |
- void Set(HKEY key); |
- |
- // Transfers ownership away from this object. |
- HKEY Take(); |
- |
- // Returns false if this key does not have the specified value, or if an error |
- // occurrs while attempting to access it. |
- bool HasValue(const wchar_t* value_name) const; |
- |
- // Returns the number of values for this key, or 0 if the number cannot be |
- // determined. |
- DWORD GetValueCount() const; |
- |
- // Determine the nth value's name. |
- LONG GetValueNameAt(int index, std::wstring* name) const; |
- |
- // True while the key is valid. |
- bool Valid() const { return key_ != NULL; } |
- |
- // Kill a key and everything that live below it; please be careful when using |
- // it. |
- LONG DeleteKey(const wchar_t* name); |
- |
- // Deletes an empty subkey. If the subkey has subkeys or values then this |
- // will fail. |
- LONG DeleteEmptyKey(const wchar_t* name); |
- |
- // Deletes a single value within the key. |
- LONG DeleteValue(const wchar_t* name); |
- |
- // Getters: |
- |
- // Returns an int32 value. If |name| is NULL or empty, returns the default |
- // value, if any. |
- LONG ReadValueDW(const wchar_t* name, DWORD* out_value) const; |
- |
- // Returns an int64 value. If |name| is NULL or empty, returns the default |
- // value, if any. |
- LONG ReadInt64(const wchar_t* name, int64* out_value) const; |
- |
- // Returns a string value. If |name| is NULL or empty, returns the default |
- // value, if any. |
- LONG ReadValue(const wchar_t* name, std::wstring* out_value) const; |
- |
- // Reads a REG_MULTI_SZ registry field into a vector of strings. Clears |
- // |values| initially and adds further strings to the list. Returns |
- // ERROR_CANTREAD if type is not REG_MULTI_SZ. |
- LONG ReadValues(const wchar_t* name, std::vector<std::wstring>* values); |
- |
- // Returns raw data. If |name| is NULL or empty, returns the default |
- // value, if any. |
- LONG ReadValue(const wchar_t* name, |
- void* data, |
- DWORD* dsize, |
- DWORD* dtype) const; |
- |
- // Setters: |
- |
- // Sets an int32 value. |
- LONG WriteValue(const wchar_t* name, DWORD in_value); |
- |
- // Sets a string value. |
- LONG WriteValue(const wchar_t* name, const wchar_t* in_value); |
- |
- // Sets raw data, including type. |
- LONG WriteValue(const wchar_t* name, |
- const void* data, |
- DWORD dsize, |
- DWORD dtype); |
- |
- // Starts watching the key to see if any of its values have changed. |
- // The key must have been opened with the KEY_NOTIFY access privilege. |
- // Returns true on success. |
- // To stop watching, delete this RegKey object. To continue watching the |
- // object after the callback is invoked, call StartWatching again. |
- bool StartWatching(const ChangeCallback& callback); |
- |
- HKEY Handle() const { return key_; } |
- |
- private: |
- class Watcher; |
- |
- // Calls RegDeleteKeyEx on supported platforms, alternatively falls back to |
- // RegDeleteKey. |
- static LONG RegDeleteKeyExWrapper(HKEY hKey, |
- const wchar_t* lpSubKey, |
- REGSAM samDesired, |
- DWORD Reserved); |
- |
- // Recursively deletes a key and all of its subkeys. |
- static LONG RegDelRecurse(HKEY root_key, |
- const std::wstring& name, |
- REGSAM access); |
- |
- HKEY key_; // The registry key being iterated. |
- REGSAM wow64access_; |
- scoped_ptr<Watcher> key_watcher_; |
- |
- DISALLOW_COPY_AND_ASSIGN(RegKey); |
-}; |
- |
-// Iterates the entries found in a particular folder on the registry. |
-class BASE_EXPORT RegistryValueIterator { |
- public: |
- // Construct a Registry Value Iterator with default WOW64 access. |
- RegistryValueIterator(HKEY root_key, const wchar_t* folder_key); |
- |
- // Construct a Registry Key Iterator with specific WOW64 access, one of |
- // KEY_WOW64_32KEY or KEY_WOW64_64KEY, or 0. |
- // Note: |wow64access| should be the same access used to open |root_key| |
- // previously, or a predefined key (e.g. HKEY_LOCAL_MACHINE). |
- // See http://msdn.microsoft.com/en-us/library/windows/desktop/aa384129.aspx. |
- RegistryValueIterator(HKEY root_key, |
- const wchar_t* folder_key, |
- REGSAM wow64access); |
- |
- ~RegistryValueIterator(); |
- |
- DWORD ValueCount() const; |
- |
- // True while the iterator is valid. |
- bool Valid() const; |
- |
- // Advances to the next registry entry. |
- void operator++(); |
- |
- const wchar_t* Name() const { return name_.c_str(); } |
- const wchar_t* Value() const { return vector_as_array(&value_); } |
- // ValueSize() is in bytes. |
- DWORD ValueSize() const { return value_size_; } |
- DWORD Type() const { return type_; } |
- |
- int Index() const { return index_; } |
- |
- private: |
- // Read in the current values. |
- bool Read(); |
- |
- void Initialize(HKEY root_key, const wchar_t* folder_key, REGSAM wow64access); |
- |
- // The registry key being iterated. |
- HKEY key_; |
- |
- // Current index of the iteration. |
- int index_; |
- |
- // Current values. |
- std::wstring name_; |
- std::vector<wchar_t> value_; |
- DWORD value_size_; |
- DWORD type_; |
- |
- DISALLOW_COPY_AND_ASSIGN(RegistryValueIterator); |
-}; |
- |
-class BASE_EXPORT RegistryKeyIterator { |
- public: |
- // Construct a Registry Key Iterator with default WOW64 access. |
- RegistryKeyIterator(HKEY root_key, const wchar_t* folder_key); |
- |
- // Construct a Registry Value Iterator with specific WOW64 access, one of |
- // KEY_WOW64_32KEY or KEY_WOW64_64KEY, or 0. |
- // Note: |wow64access| should be the same access used to open |root_key| |
- // previously, or a predefined key (e.g. HKEY_LOCAL_MACHINE). |
- // See http://msdn.microsoft.com/en-us/library/windows/desktop/aa384129.aspx. |
- RegistryKeyIterator(HKEY root_key, |
- const wchar_t* folder_key, |
- REGSAM wow64access); |
- |
- ~RegistryKeyIterator(); |
- |
- DWORD SubkeyCount() const; |
- |
- // True while the iterator is valid. |
- bool Valid() const; |
- |
- // Advances to the next entry in the folder. |
- void operator++(); |
- |
- const wchar_t* Name() const { return name_; } |
- |
- int Index() const { return index_; } |
- |
- private: |
- // Read in the current values. |
- bool Read(); |
- |
- void Initialize(HKEY root_key, const wchar_t* folder_key, REGSAM wow64access); |
- |
- // The registry key being iterated. |
- HKEY key_; |
- |
- // Current index of the iteration. |
- int index_; |
- |
- wchar_t name_[MAX_PATH]; |
- |
- DISALLOW_COPY_AND_ASSIGN(RegistryKeyIterator); |
-}; |
- |
-} // namespace win |
-} // namespace base |
- |
-#endif // BASE_WIN_REGISTRY_H_ |