Функции управления реестром Windows

ФУНКЦИИ УПРАВЛЕНИЯ РЕЕСТРОМ 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. Любое другое значение является ошибкой.