Системное программирование в среде Windows

Управление значениями

Для перечисления значений параметров открытого раздела реестра используется функция RegEnumValue. Значение параметра dwIndex должно устанавливаться равным 0 при первом вызове функции и увеличиваться на единицу при каждом последующем вызове. После возврата из функции вы получаете строку, содержащую имя перечисляемого параметра, а также размер данных. Кроме того, вы получаете значение перечисляемого параметра и его тип. 

LONG RegEnumValue(HKEY hKey, DWORD dwIndex, LPTSTR lpValueName, LPDWORD lpcbValueName, LPDWORD lpReserved, LPDWORD lpType, LPBYTE lpData, LPDWORD lpcbData)

Фактическое значение параметра возвращается в буфере, на который указывает указатель lpData. Размер результата содержится в переменной, на которую указывает указатель lpcbData. Тип данных, содержащийся в переменной, на которую указывает указатель lpType, может быть самым различным, включая REG_BINARY, REG_DWORD, REG_SZ (строка) и REG_EXPAND_SZ (расширяемая строка с параметрами, которые заменяются переменными окружения). Полный список типов данных системного реестра можно найти в оперативной справочной системе.

Чтобы определить, все ли параметры перечислены, следует проверить возвращаемое значение функции. После успешного нахождения действительного параметра оно должно быть равным ERROR_SUCCESS.

Функция RegQueryValueEx ведет себя аналогичным образом, за исключением того, что требует указания имени перечисляемого параметра, а не его индекса. Эту функцию можно использовать в тех случаях, когда известны имена параметров. Если же имена параметров неизвестны, следует использовать функцию RegEnumValueEx.

Для установки значения параметра в открытом разделе служит функция RegSetValueEx, которой необходимо предоставить имя параметра, тип значения и фактические данные, образующие значение.

LONG RegSetValueEx(HKEY hKey, LPCTSTR lpValueName, DWORD Reserved, DWORD dwType, CONST BYTE * lpData, CONST cbData)

Наконец, для удаления именованных значений используется функция RegDeleteValue.

Пример: вывод списка разделов и содержимого реестра

Программа lsReq (программа 3.4), является видоизменением lsW (программа 3.2, предназначенная для вывода списка файлов и каталогов) и обрабатывает не каталоги и файлы, а разделы и пары "имя-значение" системного реестра.

Программа 3.4. lsReq: вывод списка разделов и содержимого системного реестра

/* Глава 3. lsReg: Команда вывода содержимого реестра. Адаптированная версия программы 3.2. */
/* lsReg [параметры] подраздел */
#include "EvryThng.h"
BOOL TraverseRegistry(HKEY, LPTSTR, LPTSTR, LPBOOL);
BOOL DisplayPair(LPTSTR, DWORD, LPBYTE, DWORD, LPBOOL);
BOOL DisplaySubKey (LPTSTR, LPTSTR, PFILETIME, LPBOOL);

int _tmain(int argc, LPTSTR argv[]) {
 BOOL Flags[2], ok = TRUE;
 TCHAR KeyName[MAX_PATH + 1];
 LPTSTR pScan;
 DWORD i, KeyIndex;
 HKEY hKey, hNextKey;
 /* Таблица предопределенных имен и дескрипторов разделов. */
 LPTSTR PreDefKeyNames[] = {
 _Т("HKEY_LOCAL_MACHINE"), _T("HKEY_CLASSES_ROOT"),
 _Т("HKEY CURRENT USER"), _T ("HKEY CURRENT CONFIG"), NULL
 };
 HKEY PreDefKeys[] = {
 HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, HKEY_CURRENT_USER, HKEY_CURRENT_CONFIG
 };
 KeyIndex = Options(argc, argv, _T("Rl"), &Flags[0], &Flags[1], NULL);
/* "Разобрать" шаблон поиска на "раздел" и "подраздел". */
 /* Воссоздать раздел. */
 pScan = argv[KeyIndex];
 for (i = 0; *pScan != _T('\\') && *pScan != _T('\0'); pScan++, i++) KeyName [i] = *pScan;
 KeyName[i] = _T('\0');
 if (*pScan == _T('\\')) pScan++;
 /* Преобразовать предопределенное имя раздела в соответствующий HKEY.*/
 for (i = 0; PreDefKeyNames [i] != NULL && _tcscmp(PreDefKeyNames[i], KeyName) != 0; i++);
 hKey = PreDefKeys[i];
 RegOpenKeyEx(hKey, pScan, 0, KEY_READ, &hNextKey);
 hKey = hNextKey;
 ok = TraverseRegistry(hKey, argv[KeyIndex], NULL, Flags);
 return ok ? 0 : 1;
}

BOOL TraverseRegistry(HKEY hKey, LPTSTR FullKeyName, LPTSTR SubKey, LPBOOL Flags)
/*Совершить обход разделов и подразделов реестра, если задан параметр –R.*/
{
 HKEY hSubK;
 BOOL Recursive = Flags[0];
 LONG Result;
 DWORD ValType, Index, NumSubKs, SubKNameLen, ValNameLen, ValLen;
 DWORD MaxSubKLen, NumVals, MaxValNameLen, MaxValLen;
 FILETIME LastWriteTime;
 LPTSTR SubKName, ValName;
 LPBYTE Val;
 TCHAR FullSubKName[MAX_PATH + 1];
 /* Открыть дескриптор раздела. */
 RegOpenKeyEx(hKey, SubKey, 0, KEY_READ, &hSubK);
 /* Определить максимальный размер информации относительно раздела и распределить память. */
 RegQueryInfoKey(hSubK, NULL, NULL, NULL, &NumSubKs, &MaxSubKLen, NULL, &NumVals, &MaxValNameLen, &MaxValLen, NULL, &LastWriteTime);
 SubKName = malloc (MaxSubKLen+1); /* Размер без учета завершающего нулевого символа. */
 ValName = malloc(MaxValNameLen+1); /* Учесть нулевой символ. */