ФУНКЦИИ УПРАВЛЕНИЯ РЕЕСТРОМ WINDOWS
Введение
В табл.1 сведены все функции системного реестра, а описание основных следует непосредственно после таблицы.
Таблица 1 Сводка функций системного реестра
| Функция | Назначение |
| RegCloseKey | Закрывает открытый ключ системного реестра |
| RegConnectRegistry | Выполняет соединение с предопределенным дескриптором системного реестра на другом компьютере |
| RegCreateKeyEx | Создает новый подключ |
| RegDeleteKey | Удаляет ключ из системного реестра |
| RegDeleteValue | Удаляет значение из системного реестра |
| RegDisablePredefinedCashe | Отключает таблицу предопределенных дескрипторов системного реестра в ключе HKCU для текущего процесса |
| RegEnumKeyEx | Перечисляет все подключи данного ключа |
| RegEnumValue | Перечисляет все значения данного ключа |
| RegFlushKey | Сразу же записывает все изменения, произведенные в системном реестре |
| RegLoadKey | Загружает раздел в корневой ключ, находящийся на вершине иерархии |
| RegNotifyChangeKeyValue | Указывает на момент изменения ключа или значения в системном реестре |
| RegOpenCurrentUser | Открывает ключ HKCU для пользователя текущей потока |
| RegOpenKeyEx | Открывает существующий ключ системного реестра с расширением Win32 |
| RegOverridePredefKey | Переопределяет переопределенный ключ системного реестра в соответствии с указанным ключом системного реестра |
| RegQueryInfoKey | Возвращает информацию о ключе |
| RegQueryMultipleValues | Выбирает тип и данные для списка имен значений |
| RegQueryValueEx | Возвращает значение (с расширенными типами данных Win32) |
| RegReplaceKey | Заменяет ключ содержимым файла при перезапуске системы |
| RegRestoreKey | Считывает содержимое раздела ранее сохраненный ключ |
| RegSaveKey | Сохраняет значения и подключи данного ключа в файле улья |
| RegSetValueEx | Присваивает ключу значение (с новыми типами данных) |
| RegUnLoadKey | Удаляет раздел из системного реестра |
1. Создание и открытие ключей
Для того чтобы работать с данными реестра, приложение должно сначала создать собственный ключ или открыть ключ, созданный ранее. Для создания ключа приложению необходимо вызвать функцию RegCreateKeyEx(), которая описана в файле winreg.h так:
LONG RegCreateKeyEx (HKEY hKey, LPCSTR lpSubKey, DWORD Reserved, LPSTR lpClass, DWORD dwOptions, REGSAM samDesired, LPSECURITY_ATTRIBUTES lpSecurityAttributes, PHKEY phkResult, LPDWORD lpdwDisposition)
Параметры:
hKey – хэндл ключа, под которым предполагается создать новый подключ.
lpSubKey – указатель на строку, завершающуюся нулевым символом в конце и содержащую имя нового ключа.
Reserved – резерв.
lpClass – указатель на строку, завершающуюся нулевым символом в конце и содержащую наименование класса нового ключа.
dwOptions – специальные опции для хранения данных, связанных с ключом. Задаются идентификатором с префиксом REG_OPTION_.
samDesired – доступ к ключу с требуемым уровнем защиты.
lpSecurityAttributes – атрибуты защиты ключа.
phkResult – указатель на переменную HKEY, которой присваивается хэндл нового ключа.
lpdwDisposition – указатель на переменную типа DWORD, которой присваивается значение состояния подключа (был создан или открыт).
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является свидетельством того, что при создании или открытии ключа встретилась ошибка.
Первый аргумент - hKey -хэндл ранее открытого ключа или одно из следующих значений:
HKEY_CLASSES_ROOT;
HKEY_CURRENT_USER;
HKEY_LOCAL_MACHINE;
HKEY_USERS;
HKEY_DYN_DATA (Win 9x) или HKEY_PERFORMANCE_DATA (Win NT/2000)
При инсталляции Windows создаются пять ключей. Их имена совпадают со значениями, приведенными выше. Другими словами, эти ключи являются основой для создания иерархии ключей.
Ключи, находящиеся по иерархии ниже первого из предопределенных ключей, HKEY_LOCAL_MACHINE, определяют физическое состояние компьютера, включая данные о типе шины, системной памяти, инсталлированном аппаратном и программном обеспечении.
Ключи, находящиеся по иерархии ниже HKEY_CLASSES_ROOT, определяют типы (или классы) файлов и свойства, ассоциированные с этими классами. Свойства классов определяются только программистом. Обычно эти свойства применяются при работе приложений, использующих внедрение и связывание объектов, а также приложений, использующих среду Windows (shell applications). К примеру, при открытии файлов в Explorer'e используются свойства файлов, записанные в реестре.
Ключи, подчиненные HKEY_USERS, определяют конфигурацию по умолчанию при подключении нового пользователя на локальной машине и конфигурацию текущего пользователя.
И наконец, ключи, подчиненные HKEY_CURRENT_USER, определяют установки, сделанные текущим пользователем, касающиеся переменных окружения, данных о принтерах, сетевых подключениях и т. д. Кроме этого, в этой ветви дерева хранятся установки, сделанные конкретными приложениями.
Возвращаясь к аргументам функции RegCreateKeyEx(), можно сказать, что перед созданием нового ключа необходимо продумать, в какую ветвь дерева необходимо включить новый ключ. Если новый ключ необходимо создать подчиненным ключу более низкого уровня, то определенным образом можно пройти по дереву и найти тот ключ, который необходим. Кроме этого, ключ, хэндл которого указан в первом аргументе, должен быть открыт с атрибутом доступа KEY_CREATE_SUB_KEY.
Вторым аргументом - lpSubKey - является указатель на строку, содержащую имя создаваемого ключа. Создаваемый ключ будет подчиненным ключа, хэндл которого указан в первом аргументе.
Третий аргумент - Reserved -зарезервирован и должен быть равным нулю.
Четвертый аргумент - lpClass - указатель на строку, определяющую класс создаваемого ключа.
Очередной, пятый аргумент - dwOptions, определяет опции создаваемого ключа. Этот аргумент может принимать одно из значений:
• REG_OPTION_VOLATILE
• REG_OPTION_NON_VOLATILE.
В Windows 9x первое значение не используется.
Второе значение указывает, что при перезагрузке системы значение этого ключа сохраняется, т. е. информация сохраняется в файле, а не в памяти.
Следующий, шестой аргумент - samDesired, определяет маску доступа к ключу. Этот параметр представляет собой битовую шкалу и может быть комбинацией флагов, приведенных в табл.2.
Таблица 2 Флаги, составляющие маску доступа к ключу
| Флаг | Описание |
| KEY_QUERY_VALUE | Права запрашивать данные подключен |
| KEY_SET_VALUE | Права устанавливать данные подключен |
| KEY_CREATE_SUB _KEY | Права создавать подключи |
| KEY_ENUMERATE_SUB_ KEY | Права перебирать подключи |
| KEY_NOTIFY | Права изменять нотификацию |
| KEY_CREATE LINK | Права создавать символическую связь |
| KEY_READ | (STANDARD RIGHTS READ) KEY_QUERY_VALUE | KEY_ENUMERATE SUB_KEYS | KEY_NOTIFY |
| KEY_WRITE | (STANDARD RIGHTS WRITE) KEY_SET_VALUE | KEY_CREATE_SUB_KEY |
| KEY_EXECUTE | KEY_READ |
| KEY_ALL_ACCESS | (STANDARD RIGHTS ALL) KEY_QUERY VALUE | KEY_SET_VALUE | KEY_CREATE _SUB_KEY | KEY_ENUMERATE_SUB_KEYS | KEY_CREATE_SUB_KEY | KEY_NOTIFY | KEY _CREATE_LINK |
Седьмой аргумент - lpSecurityAttributes - указатель на структуру типа SECURITY_ATTRIBUTES, которая определяет атрибуты безопасности создаваемого ключа. Windows 9х не поддерживает безопасность, поэтому этот параметр игнорируется.
Туда, куда указывает восьмой аргумент - phkResult - записывается хэндл созданного ключа.
И наконец, последний, девятый аргумент - lpdwDisposition - указывает место, куда будет записана информация о том, что произошло с ключом. Дело в том, что если с помощью этой функции производится попытка создать ключ, который уже существует, то ключ не создается, а просто открывается. Поэтому приложению необходимо знать, что произошло при создании ключа.
Если ключ был создан, то в поле, определяемое lpdwDisposition, записывается значение REG_CREATED_NEW_KEY.
В том случае, если ключ существовал и был открыт, записываемое значение равно REG_OPENED_EXISTING_KEY.
Это поле может быть использовано и для того, чтобы узнать, не открыт ли ключ другим приложением. Открытый ключ доступен только тому приложению, которое создало его. Таким образом, если приложение открывает заведомо существующий ключ и получает в ответ значение REG_CREATED_NEW_KEY, то можно сделать вывод о том, что ключ занят другим приложением.
Для ОТКРЫТИЯ подключа системного реестра с требуемым типом доступа служит функция RegOpenKeyEx(). Эта функция не создает ключ, если он не существует. Вместо этого она возвращает код ошибки.
LONG RegOpenKeyEx (HKEY hKey, LPCSTR lpSubKey, DWORD Reserved, REGSAM samDesired, PHKEY phkResult)
Параметры:
hKey – хэндл открываемого ключа.
lpSubKey – указатель на строку, завершающуюся нулевым символом в конце и содержащую имя нового ключа.
Reserved – резерв.
samDesired – доступ к ключу с требуемым уровнем защиты.
phkResult – указатель на переменную HKEY, которой присваивается хэндл нового ключа.
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является ошибкой.
2. Закрытие ключей и сохранение произведенных в них изменений
Закрывается ключ с помощью функции RegCloseKey(). При этом освобождаются любые связанные с данным ключом системные ресурсы. Закрытие ключа отнюдь не вызывает задержку операций записи, происходящих непосредственно после выполнения данной функции. Синтаксис функции следующий:
LONGRegCloseKey (HKEYhKey)
Параметры:
hKey – хэндл закрываемого ключа.
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является ошибкой.
Проблема. Дело в том, что данные из реестра на время работы с ними переписываются в кэш и записываются обратно на диск при выполнении функции RegFlushKey(). Чтобы данные, измененные во время работы программы, не были потеряны, то перед закрытием ключа следует их сбрасывать на диск. С другой стороны, у программиста может появиться соблазн сбрасывать данные на диск достаточно часто. Так как RegFlushKey() использует огромное количество системных ресурсов, то эту функцию нужно вызывать только в том случае, когда действительно в этом есть необходимость. Синтаксис функции следующий: