Функция RegLoadKeyA (winreg.h)
Создает подраздел в разделе HKEY_USERS или HKEY_LOCAL_MACHINE и загружает данные из указанного куста реестра в этот подраздел.
Приложения, которые выполняют резервное копирование или восстановление состояния системы, включая системные файлы и кусты реестра, должны использовать службу теневого копирования томов вместо функций реестра.
Синтаксис
LSTATUS RegLoadKeyA(
[in] HKEY hKey,
[in, optional] LPCSTR lpSubKey,
[in] LPCSTR lpFile
);
Параметры
[in] hKey
Дескриптор ключа, в котором будет создан подраздел. Это может быть дескриптор, возвращаемый вызовом RegConnectRegistryили одним из следующих предопределенных дескрипторов:
HKEY_LOCAL_MACHINEHKEY_USERS Эта функция всегда загружает сведения в верхней части иерархии реестра. Для этого параметра нельзя указать значения HKEY_CLASSES_ROOT и HKEY_CURRENT_USER, так как они представляют подмножества HKEY_LOCAL_MACHINE и HKEY_USERS обрабатывать значения соответственно.
[in, optional] lpSubKey
Имя ключа, создаваемого в разделе hKey. В этом подразделе будут загружены сведения о регистрации из файла.
Имена ключей не учитывает регистр.
Дополнительные сведения см. в разделе Ограничения размера элемента реестра.
[in] lpFile
Имя файла, содержащего данные реестра. Этот файл должен быть локальным файлом, который был создан с помощью функции RegSaveKey. Если этот файл не существует, создается файл с указанным именем.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение ERROR_SUCCESS.
Если функция завершается ошибкой, возвращаемое значение представляет собой ненулевой код ошибки, определенный в Winerror.h. Функцию FormatMessage можно использовать с флагом FORMAT_MESSAGE_FROM_SYSTEM для получения универсального описания ошибки.
Замечания
Существует два формата файлов hive реестра. Кусты реестра, созданные в текущих операционных системах, обычно не могут загружаться более ранними.
Если hKey является дескриптором, возвращаемым RegConnectRegistry, то путь, указанный в lpFile, равен удаленному компьютеру.
Вызов должен иметь права SE_RESTORE_NAME и SE_BACKUP_NAME на компьютере, в котором находится реестр. Дополнительные сведения см. в разделе Выполнение с специальными привилегиями. Чтобы загрузить куст, не требуя этих специальных привилегий, используйте функцию RegLoadAppKey.
Заметка
Заголовок winreg.h определяет RegLoadKey как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | winreg.h (включая Windows.h) |
| библиотеки |
Advapi32.lib |
| DLL | Advapi32.dll |