Смекни!
smekni.com

Функции управления реестром Windows (стр. 1 из 2)

ФУНКЦИИ УПРАВЛЕНИЯ РЕЕСТРОМ 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() использует огромное количество системных ресурсов, то эту функцию нужно вызывать только в том случае, когда действительно в этом есть необходимость. Синтаксис функции следующий: