1 ///////////////////////////////////////////////////////////////////////////////
2 // MuldeR's Utilities for Qt
3 // Copyright (C) 2004-2015 LoRd_MuldeR <MuldeR2@GMX.de>
5 // This library is free software; you can redistribute it and/or
6 // modify it under the terms of the GNU Lesser General Public
7 // License as published by the Free Software Foundation; either
8 // version 2.1 of the License, or (at your option) any later version.
10 // This library is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 // Lesser General Public License for more details.
15 // You should have received a copy of the GNU Lesser General Public
16 // License along with this library; if not, write to the Free Software
17 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 // http://www.gnu.org/licenses/lgpl-2.1.txt
20 //////////////////////////////////////////////////////////////////////////////////
25 #include <MUtils/Registry.h>
26 #include <MUtils/Exception.h>
29 #include <QStringList>
32 #define WIN32_LEAN_AND_MEAN
36 ///////////////////////////////////////////////////////////////////////////////
38 ///////////////////////////////////////////////////////////////////////////////
40 #define ENUM2STR(X,Y) do \
42 static const char *_name = #Y; \
43 if((X) == (Y)) return _name; \
51 static HKEY
registry_root(const reg_root_t
&rootKey
)
55 case root_classes
: return HKEY_CLASSES_ROOT
; break;
56 case root_user
: return HKEY_CURRENT_USER
; break;
57 case root_machine
: return HKEY_LOCAL_MACHINE
; break;
58 default: MUTILS_THROW("Unknown root reg value was specified!");
62 static DWORD
registry_access(const reg_access_t
&access
)
66 case access_readonly
: return KEY_READ
; break;
67 case access_writeonly
: return KEY_WRITE
; break;
68 case access_readwrite
: return KEY_READ
| KEY_WRITE
; break;
69 case access_enumerate
: return KEY_ENUMERATE_SUB_KEYS
; break;
70 default: MUTILS_THROW("Unknown access value was specified!");
74 static const char* reg_root2str(const reg_root_t
&rootKey
)
76 ENUM2STR(rootKey
, root_classes
);
77 ENUM2STR(rootKey
, root_user
);
78 ENUM2STR(rootKey
, root_machine
);
80 static const char *unknown
= "<unknown>";
84 static const char* reg_access2str(const reg_access_t
&access
)
86 ENUM2STR(access
, access_readonly
);
87 ENUM2STR(access
, access_writeonly
);
88 ENUM2STR(access
, access_readwrite
);
89 ENUM2STR(access
, access_enumerate
);
91 static const char *unknown
= "<unknown>";
97 ///////////////////////////////////////////////////////////////////////////////
98 // RegistryKeyPrivate Key Class
99 ///////////////////////////////////////////////////////////////////////////////
107 class RegistryKeyPrivate
109 friend class MUtils::Registry::RegistryKey
;
120 #define CHECK_STATUS(X) do \
124 MUTILS_THROW("Cannot read from or write to a key is not currently open!"); \
126 if(!(p->m_access & (X))) \
128 MUTILS_THROW("This operation is not support with current access rights!"); \
133 ///////////////////////////////////////////////////////////////////////////////
134 // Registry Key Class
135 ///////////////////////////////////////////////////////////////////////////////
137 MUtils::Registry::RegistryKey::RegistryKey(const reg_root_t
&rootKey
, const QString
&keyName
, const reg_access_t
&access
)
139 p(new Internal::RegistryKeyPrivate())
142 p
->m_access
= registry_access(access
);
145 p
->m_isOpen
= (RegCreateKeyEx(registry_root(rootKey
), MUTILS_WCHR(keyName
), 0, NULL
, 0, p
->m_access
, NULL
, &p
->m_hKey
, NULL
) == ERROR_SUCCESS
);
148 qWarning("Failed to open registry key \"%s\"! (rootKey: %s, access: %s)", MUTILS_UTF8(keyName
), reg_root2str(rootKey
), reg_access2str(access
));
152 MUtils::Registry::RegistryKey::~RegistryKey(void)
156 CloseHandle(p
->m_hKey
);
163 inline bool MUtils::Registry::RegistryKey::isOpen(void)
168 bool MUtils::Registry::RegistryKey::value_write(const QString
&valueName
, const quint32
&value
)
170 CHECK_STATUS(KEY_WRITE
);
171 return (RegSetValueEx(p
->m_hKey
, valueName
.isEmpty() ? NULL
: MUTILS_WCHR(valueName
), 0, REG_DWORD
, reinterpret_cast<const BYTE
*>(&value
), sizeof(quint32
)) == ERROR_SUCCESS
);
174 bool MUtils::Registry::RegistryKey::value_write(const QString
&valueName
, const QString
&value
)
176 CHECK_STATUS(KEY_WRITE
);
177 return (RegSetValueEx(p
->m_hKey
, valueName
.isEmpty() ? NULL
: MUTILS_WCHR(valueName
), 0, REG_SZ
, reinterpret_cast<const BYTE
*>(value
.utf16()), (value
.length() + 1) * sizeof(wchar_t)) == ERROR_SUCCESS
);
180 bool MUtils::Registry::RegistryKey::value_read(const QString
&valueName
, quint32
&value
) const
183 DWORD size
= sizeof(quint32
), type
= -1;
184 CHECK_STATUS(KEY_READ
);
185 return (RegQueryValueEx(p
->m_hKey
, valueName
.isEmpty() ? NULL
: MUTILS_WCHR(valueName
), 0, &type
, reinterpret_cast<BYTE
*>(&value
), &size
) == ERROR_SUCCESS
) && (type
== REG_DWORD
);
188 bool MUtils::Registry::RegistryKey::value_read(const QString
&valueName
, QString
&value
) const
191 wchar_t buffer
[2048]; DWORD size
= sizeof(wchar_t) * 2048, type
= -1;
192 CHECK_STATUS(KEY_READ
);
193 if((RegQueryValueEx(p
->m_hKey
, valueName
.isEmpty() ? NULL
: MUTILS_WCHR(valueName
), 0, &type
, reinterpret_cast<BYTE
*>(&(buffer
[0])), &size
) == ERROR_SUCCESS
) && ((type
== REG_SZ
) || (type
== REG_EXPAND_SZ
)))
195 value
= QString::fromUtf16(reinterpret_cast<const ushort
*>(buffer
));
201 bool MUtils::Registry::RegistryKey::enum_values(QStringList
&list
) const
203 wchar_t buffer
[2048];
205 CHECK_STATUS(KEY_QUERY_VALUE
);
206 for(DWORD i
= 0; i
< UINT_MAX
; i
++)
209 const DWORD ret
= RegEnumValue(p
->m_hKey
, i
, buffer
, &size
, NULL
, NULL
, NULL
, NULL
);
210 if(ret
== ERROR_SUCCESS
)
212 list
<< QString::fromUtf16(reinterpret_cast<const ushort
*>(buffer
));
215 return (ret
== ERROR_NO_MORE_ITEMS
);
220 bool MUtils::Registry::RegistryKey::enum_subkeys(QStringList
&list
) const
222 wchar_t buffer
[2048];
224 CHECK_STATUS(KEY_ENUMERATE_SUB_KEYS
);
225 for(DWORD i
= 0; i
< UINT_MAX
; i
++)
228 const DWORD ret
= RegEnumKeyEx(p
->m_hKey
, i
, buffer
, &size
, NULL
, NULL
, NULL
, NULL
);
229 if(ret
== ERROR_SUCCESS
)
231 list
<< QString::fromUtf16(reinterpret_cast<const ushort
*>(buffer
));
234 return (ret
== ERROR_NO_MORE_ITEMS
);
239 ///////////////////////////////////////////////////////////////////////////////
241 ///////////////////////////////////////////////////////////////////////////////
244 * Write registry value
246 bool MUtils::Registry::reg_value_write(const reg_root_t
&rootKey
, const QString
&keyName
, const QString
&valueName
, const quint32
&value
)
248 bool success
= false;
249 RegistryKey
regKey(rootKey
, keyName
, access_readwrite
);
252 success
= regKey
.value_write(valueName
, value
);
258 * Write registry value
260 bool MUtils::Registry::reg_value_write(const reg_root_t
&rootKey
, const QString
&keyName
, const QString
&valueName
, const QString
&value
)
262 bool success
= false;
263 RegistryKey
regKey(rootKey
, keyName
, access_readwrite
);
266 success
= regKey
.value_write(valueName
, value
);
272 * Read registry value
274 bool MUtils::Registry::reg_value_read(const reg_root_t
&rootKey
, const QString
&keyName
, const QString
&valueName
, quint32
&value
)
276 bool success
= false;
277 RegistryKey
regKey(rootKey
, keyName
, access_readonly
);
280 success
= regKey
.value_read(valueName
, value
);
290 * Read registry value
292 bool MUtils::Registry::reg_value_read(const reg_root_t
&rootKey
, const QString
&keyName
, const QString
&valueName
, QString
&value
)
294 bool success
= false;
295 RegistryKey
regKey(rootKey
, keyName
, access_readonly
);
298 success
= regKey
.value_read(valueName
, value
);
308 * Enumerate value names
310 bool MUtils::Registry::reg_enum_values(const reg_root_t
&rootKey
, const QString
&keyName
, QStringList
&values
)
312 bool success
= false;
313 RegistryKey
regKey(rootKey
, keyName
, access_readonly
);
316 success
= regKey
.enum_values(values
);
326 * Enumerate subkey names
328 bool MUtils::Registry::reg_enum_subkeys(const reg_root_t
&rootKey
, const QString
&keyName
, QStringList
&subkeys
)
330 bool success
= false;
331 RegistryKey
regKey(rootKey
, keyName
, access_enumerate
);
334 success
= regKey
.enum_subkeys(subkeys
);
344 * Check registry key existence
346 bool MUtils::Registry::reg_key_exists(const reg_root_t
&rootKey
, const QString
&keyName
)
349 if(RegOpenKeyEx(registry_root(rootKey
), MUTILS_WCHR(keyName
), 0, STANDARD_RIGHTS_READ
, &hKey
) == ERROR_SUCCESS
)
358 * Delete registry key
360 bool MUtils::Registry::reg_key_delete(const reg_root_t
&rootKey
, const QString
&keyName
)
362 return (SHDeleteKey(registry_root(rootKey
), MUTILS_WCHR(keyName
)) == ERROR_SUCCESS
);