Функция RegCopyTreeA (winreg.h)

  • Статья

Копирует указанный раздел реестра, а также его значения и подразделы в указанный раздел назначения.

Синтаксис

LSTATUS RegCopyTreeA(
  [in]           HKEY   hKeySrc,
  [in, optional] LPCSTR lpSubKey,
  [in]           HKEY   hKeyDest
);

Параметры

[in] hKeySrc

Дескриптор открытого раздела реестра. Ключ должен быть открыт с правом доступа KEY_READ. Дополнительные сведения см. в разделе Безопасность раздела реестра и права доступа.

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

[in, optional] lpSubKey

Имя ключа. Этот ключ должен быть подразделом ключа, определяемого параметром hKeySrc . Этот параметр также может иметь значение NULL.

[in] hKeyDest

Дескриптор ключа назначения. Вызывающий процесс должен иметь KEY_CREATE_SUB_KEY доступ к ключу.

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

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой ненулевой код ошибки, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.

Комментарии

Эта функция также копирует дескриптор безопасности для ключа.

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Примечание

Заголовок winreg.h определяет RegCopyTree в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header winreg.h (включая Windows.h)
Библиотека Advapi32.lib
DLL Advapi32.dll

См. также раздел

Функции реестра