RegRestoreKeyA 함수(winreg.h)

지정된 파일에서 레지스트리 정보를 읽고 지정된 키 위에 복사합니다. 이 레지스트리 정보는 키와 여러 수준의 하위 키 형식일 수 있습니다.

시스템 파일 및 레지스트리 하이브를 포함하여 시스템 상태를 백업하거나 복원하는 애플리케이션은 레지스트리 함수 대신 볼륨 섀도 복사본 서비스 사용해야 합니다.

통사론

LSTATUS RegRestoreKeyA(
  [in] HKEY   hKey,
  [in] LPCSTR lpFile,
  [in] DWORD  dwFlags
);

매개 변수

[in] hKey

열린 레지스트리 키에 대한 핸들입니다. 이 핸들은 RegCreateKeyEx 또는 RegOpenKeyEx 함수에서 반환됩니다. 또한 다음 미리 정의된 키중 하나일 수도 있습니다.

HKEY_CLASSES_ROOTHKEY_CURRENT_CONFIGHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERS 이 키와 해당 하위 키에 포함된 모든 정보는 lpFile 매개 변수가 가리키는 파일의 정보로 덮어씁니다.

[in] lpFile

레지스트리 정보가 있는 파일의 이름입니다. 이 파일은 일반적으로 RegSaveKey 함수를 사용하여 생성됩니다.

[in] dwFlags

키 또는 키를 복원하는 방법을 나타내는 플래그입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 Winerror.h에 정의된 0이 아닌 오류 코드입니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다.

발언

두 가지 레지스트리 하이브 파일 형식이 있습니다. 현재 운영 체제에서 만든 레지스트리 하이브는 일반적으로 이전 운영 체제에서 로드할 수 없습니다.

hKey 매개 변수의 하위 키가 열려 있으면 regRestoreKey 실패합니다.

호출 프로세스에는 레지스트리가 있는 컴퓨터에 대한 SE_RESTORE_NAME 및 SE_BACKUP_NAME 권한이 있어야 합니다. 자세한 내용은 특수 권한실행을 참조하세요.

이 함수는 지정된 키 아래의 키와 값을 파일의 최상위 키 이름에 관계없이 파일의 최상위 키에 보조인 키와 값으로 바꿉니다. 예를 들어 hKey 하위 키 B 및 C를 사용하여 키 A를 식별할 수 있으며, lpFile 매개 변수는 하위 키 Y 및 Z가 있는 X 키를 포함하는 파일을 지정합니다. RegRestoreKey호출한 후 레지스트리에는 하위 키가 Y 및 Z인 키 A가 포함됩니다. A의 값 항목은 X의 값 항목으로 대체됩니다.

lpFile 지정된 파일의 새 정보는 키 이름을 제외하고 hKey 매개 변수에 지정된 키의 내용을 덮어씁니다.

hKey 원격 컴퓨터의 키를 나타내는 경우 lpFile 설명된 경로는 원격 컴퓨터를 기준으로 합니다.

요구 사항

참고 항목

RegDeleteKey

RegLoadKey

RegReplaceKey

RegSaveKey

레지스트리 함수

레지스트리 개요