RegLoadKey

Функция 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.