Функция SHCopyKeyA (shlwapi.h)

Статья
11/20/2024

Рекурсивно копирует вложенные ключи и значения исходного подраздела в целевой ключ. SHCopyKey не копирует атрибуты безопасности ключей.

Синтаксис

LSTATUS SHCopyKeyA(
  [in]           HKEY   hkeySrc,
  [in, optional] LPCSTR pszSrcSubKey,
  [in]           HKEY   hkeyDest,
                 DWORD  fReserved
);

Параметры

[in] hkeySrc

Тип: HKEY

Дескриптор исходного ключа (например, HKEY_CURRENT_USER).

[in, optional] pszSrcSubKey

Тип: LPCTSTR

Вложенный ключ, вложенные ключи и значения которого должны быть скопированы.

[in] hkeyDest

Тип: HKEY

Ключ назначения.

fReserved

Тип: DWORD

Скрытный. Должно быть 0.

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

Тип: LSTATUS

Возвращает ERROR_SUCCESS в случае успешного выполнения или одного из кодов ошибок, отличных от нуля, определенных в Winerror.h в противном случае. Используйте FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM для получения универсального описания ошибки.

Замечания

Важное Эта функция не дублирует атрибуты безопасности ключей и значений, которые он копирует. Скорее, все атрибуты безопасности в целевом ключе являются атрибутами по умолчанию.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

Поделиться через