LONGRegFlushKey(HKEYhKey)
Параметры:
hKey – хэндл ключа, содержимое которого должно быть сброшено на диск.
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является ошибкой.
3. Добавление данных к ключам и удаление данных из ключей
После того, как ключ создан, возникает необходимость добавить к ключу некоторые данные, которые будут использоваться программой. Для этого нужно вызвать функцию RegSetValueEx(). Эта функция устанавливает именнованное значение любого подключа системного реестра. У данного подключа может быть множество именованных значений. Синтаксис функции следующий:
LONG RegSetValueEx (HKEY hKey, LPCSTR lpszValueName, DWORD dwReserved, DWORD dwDataType, CONST BYTE* lpData, DWORD dwByte)
Параметры:
hKey – хэндл ключа, к которому добавляются данные.
lpszValueName– указатель на строку, завершающуюся нулевым символом в конце и содержащую имя строки добавляемых данных.
Reserved – резерв.
dwDataType – тип сохраняемых данных, который задается идентификатором (табл.4).
lpData– укзатель на данные, которые будут сохраняться в выбранном значении. Объем данных, сохраняемых в системном реестре, ограничивается используемым объемом памяти. Поэтому большие значения должны хранится в файлах, а имена этих файлов следует хранить в системном реестре.
dwByte – длина сохраняемой строки данных за исключением завершающего строку нулевого символа.
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является ошибкой.
Первый аргумент - хэндл ключа, к которому добавляются данные.
Второй аргумент - указатель на строку, содержащую имя добавляемых данных.
Третий аргумент зарезервирован.
Четвертый аргумент определяет тип информации, который будет сохранен в качестве данных.
Пятый аргумент является указателем непосредственно на данные, которые будут сохранены.
Шестой аргумент определяет размер данных, на которые указывает пятый аргумент. Все легко и просто, не так ли?
Различают два типа удаления:
- удаление подключа из реестра;
- удаление значений ключа реестра.
Удалить подключ из реестра можно с помощью функции RegDeleteKey(). В windowsNT/2000 эта функция не будет удалять подключи и не сможет быть выполнена при наличии подключей.
В Windows 9x подключи с ее помощью удаляются. Синтаксис функции следующий:
LONG RegDeleteKey (HKEY hKey, LPCSTR lpszSubKey)
Параметры:
hKey – хэндл открытого ключа.
lpszSubKey– указатель на строку, завершающуюся нулевым символом в конце и содержащую имя удаляемого подключа.
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является ошибкой.
Удалить данные можно с помощью обращения к функции RegDeleteValue(). Её синтаксис следующий:
LONG RegDeleteValue (HKEY hKey, LPCSTR lpszValueName)
Параметры:
hKey – хэндл открытого ключа.
lpszValueName– указатель на строку, завершающуюся нулевым символом в конце и содержащую имя удаляемого значения.
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является ошибкой.
4. Выборка данных из реестра
Если прикладной программе нужно осуществить выборку данных из реестра, то для начала программа должна определить, из какой ветви дерева реестра ей нужно выбрать данные. Естественно, что никаких функций для этого нет. При написании программы программист должен сам позаботиться об этом.
После того как решение принято, начинается второй этап. Программа должна перебирать все ключи в этой ветви до тех пор, пока не найдет нужный ключ. Для этого приложение может воспользоваться функцией RegEnumKeyEx(). Эта функция при каждом вызове выбирает информацию об одном ключе. Для перечисления подключей в приложении следует первоначально вызвать функцию RegEnumKeyEx() с установленным значением 0 параметра dwIndex и вызывать эту функцию до тех пор, пока не будет возвращено значение ERROR_NO_MORE_ITEMS. Синтаксис функции следующий:
LONG RegEnumKeyEx (HKEY hKey, DWORD dwIndex, LPSTR lpName, LPDWORD lpReserved, LPSTR lpClass, LPDWORD lpcbClass, PFILETIME pftLastChanged)
Параметры:
hKey – хэндл ключа, подключи которого подлежат перечислению.
dwIndex–индекс подключа для доступа к нему.
lpName – указатель на буфер, в который поступает имя перечисляемого подключа.
lpcbName – размер буфера lpName.
lpReserved – резерв.
lpClass – указатель на буфер, в который поступает имя класса подключа.
lpcbClass – размер буфера lpcbName
lpftLastWriteTime – указатель на переменную типа FILETIME, которой присваивается дата и время последней операции записи в данный подключ. Структура FILETIME содержит 64-разрядное значение, которое представляет собой число тактов через каждые 100 нс, начиная с 1 января 1601 г.
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является свидетельством того, что при создании или открытии ключа встретилась ошибка.
Если возвращается значение ERROR_NO_MORE_ITEMS, то это означает, что подключей у данного ключа больше нет.
Функция перебора объектов нам встречается впервые. Давайте сначала рассмотрим аргументы этой функции, а потом поговорим о том, что происходит при переборе ключей.
Первый аргумент - это хэндл ключа, подчиненные ключи которого будут перебираться в поисках нужного ключа.
Второй аргумент - dwIndex - является индексом требуемого подключа.
Третий аргумент - lpName - указывает на буфер, в который будет записано имя ключа.
Четвертый аргумент - lpcbName - определяет размер этого буфера в байтах.
Пятый аргумент, как следует из его названия - lpReserved - зарезервирован для использования в будущем и должен быть равным NULL.
Шестой аргумент - lpClass - должен указывать на буфер, в котором после завершения работы функции будет содержать имя класса подключа. Если это имя программе не требуется, то этот аргумент должен быть равным NULL.
Размер этого буфера определяется седьмым аргументом - lpcbClass.
Восьмой аргумент -lpftLastWriteTime - после завершения работы функции содержит время последнего обновления данного подключа.
Для того чтобы перебрать подключи, приложение должно сначала вызвать функцию RegEnumKeyEx() со вторым аргументом (dwIndex), равным нулю (поиск начинается с начала дерева). Если искомый ключ найден с первой попытки, то приложению повезло. В противном случае необходимо dwIndex увеличить на единицу и снова обратиться к функции. Так необходимо делать до тех пор, пока не будет найден искомый ключ или функция не вернет значение ERROR_NO_MORE_ITEMS. Естественно, что поиск можно производить и в обратном порядке. Для того чтобы поиск мог быть нормально осуществлен, ключ, хэндл которого указан первым аргументом, должен быть открыт с правом доступа KEY_ENUMERATE_SUB_KEYS.
Получить полную информацию о подключе можно с помощью функции RegQueryInfoKey(), аргументы которой в лекции рассматривать не будем. Допустим нужный нам подключ найден. Тогда в этом подключе необходимо найти нужные данные. Способ поиска точно такой же, как и в предыдущей функции. Для поиска необходимо перебрать все данные, связанные с подключом. Чтобы произвести этот перебор, обычно используется функция RegEnumValue(), описание которой, приведенное ниже, можно найти в файле winreg.h:
LONGRegEnumValue(HKEYhKey, DWORDdwIndex, LPSTRlpValueName, LPDWORDlpcbValueName, LPDWORDlpReserved, LPDWORDlpType, LPBYTElpData, LPDWORDlpcbData)
Параметры:
hKey – хэндл ключа, значения которого подлежат перечислению.
dwIndex–индекс перечисляемого значения.
lpValueName – указатель на буфер, в который поступает имя перечисляемого значения.
lpcbValueName – размербуфераlpValueName.
lpReserved – резерв.
lpType – указатель на значение типа DWORD, которое принимает тип данных, присущи перечисляемому значению.
lpData – указатель на буфер, в который поступает содержимое перечиляемого значения.
lpcbData – указатель на переменную, которая содержит число байт в буфере lpData.
Возвращаемое значение: если ключ создан или открыт удачно, то значение ERROR_SUCCESS. Любое другое значение является свидетельством того, что при создании или открытии ключа встретилась ошибка.
Если возвращается значение ERROR_NO_MORE_VALUES, то это означает, что подключей у данного ключа больше нет.
Порядок использования этой функции полностью совпадает с порядком использования функции RegEnumKeyEx(), поэтому стану на нем останавливаться. Опишу только аргументы этой функции.
Понятно, что hKey - это хэндл ключа, которому принадлежит подключ, индекс которого представлен вторым аргументом - dwlndex.
Следующий аргумент – указатель на буфер, в который будет записано имя подключа. lpcbValueName определяет размер этого буфера. Аргумент lpReserved зарезервирован и должен быть равным NULL. Последние три аргумента определяют класс подключа, указатель на буфер, в который будут записаны эти данные и размер буфера. После возврата функции предпоследний аргумент содержит число записанных данных.
Таким образом, работа с системным реестром представляет собой достаточно удобный механизм доступа к установленным системным ресурсам, программам и оборудованию. Существующие стандартные значения параметров реестра документированы в справочной информации, исследование которой будет производится на практических занятиях.