Функция RegLoadKey создает подключ в HKEY_USER или HKEY_LOCAL_MACHINE и записывает туда информацию из указанного файла. Эта информация реестра в форме улья. Улей – это отдельное тело ключей, подключей и значений, которые находятся на вершине иерархии реестра. Улей хранится в одном файле.
LONG RegLoadKey(
HKEY hKey, // дескриптор открытого ключа
LPCTSTR lpSubKey, // адрес имени подключа
LPCTSTR lpFile // адрес имени файла
);
Параметры:
hKey |
Определяет ключ, в котором будет создан подключ. Это может быть предопределенное значение дескриптора (HKEY_LOCAL_MACHINE или HKEY_USERS), или дескриптор, возвращенный вызовом RegConnectRegistry.
Эта функция всегда загружает информацию на вершину иерархии реестра. Значение дескрипторов HKEY_CLASSES_ROOT и HKEY_CURRENT_USER не могут указываться в этом параметре, потому что они представляют собой вложенности в HKEY_LOCAL_MACHINE и HKEY_USERS, соответственно. |
lpSubKey |
Адрес нульзаканчивающейся строки, в которой содержится имя создаваемого под hKey ключа. Это подключ, куда будем записана информация из файла. |
lpFile |
Адрес нульзаканчивающейся строки, содержащей имя файла, который содержит информацию реестра. Этот файл должен быть создан с помощью функции RegSaveKey. |
Возвращаемые значения:
Если функция успешна, возвращается значение ERROR_SUCCESS.
При ошибке, возвращаемое значение – это код ошибки, объявленный в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM для получения общего описания ошибки.
Замечания:
Если hKey – это дескриптор, возвращенный RegConnectRegistry, то путь, указанный в lpFile, относителен удаленному компьютеру.
Windows NT/2000/XP: вызывающий процесс должен иметь привилегию SE_RESTORE_NAME.
Смотрите также:
RegConnectRegistry, RegDeleteKey, RegReplaceKey, RegRestoreKey, RegSaveKey, RegUnloadKey
|