ORSaveHive 함수

  • 아티클

지정된 오프라인 레지스트리 하이브를 파일에 씁니다.

구문

DWORD ORSaveHive(
  _In_ ORHKEY Handle,
  _In_ PCWSTR lpHivePath,
  _In_ DWORD  dwOsMajorVersion,
  _In_ DWORD  dwOsMinorVersion
);

매개 변수

핸들 [in]

저장할 오프라인 레지스트리 하이브에 대한 핸들입니다.

lpHivePath [in]

레지스트리 하이브 파일의 이름을 지정하는 유니코드 문자열에 대한 포인터입니다. 기존 파일의 이름이 될 수 없습니다.

dwOsMajorVersion [in]

운영 체제의 주 버전 번호입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
5
 dwOsMinorVersion이 1이면 운영 체제는 Windows XP입니다.
dwOsMinorVersion이 2인 경우 운영 체제는 Windows Server 2003 R2, Windows Server 2003 또는 Windows XP Professional x64 Edition입니다.
6
 dwOsMinorVersion이 0인 경우 운영 체제는 Windows Server 2008 또는 Windows Vista입니다.
dwOsMinorVersion이 1인 경우 운영 체제는 Windows Server 2008 R2 또는 Windows 7입니다.

 

dwOsMinorVersion [in]

운영 체제의 부 버전 번호입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
0
 dwOsMajorVersion이 6이면 운영 체제는 Windows Server 2008 또는 Windows Vista입니다.
1
 dwOsMajorVersion이 5이면 운영 체제는 Windows XP입니다.
dwOsMajorVersion이 6인 경우 운영 체제는 Windows Server 2008 R2 또는 Windows 7입니다.
2
 dwOsMajorVersion이 5인 경우 운영 체제는 Windows Server 2003 R2, Windows Server 2003 또는 Windows XP Professional x64 Edition입니다.
dwOsMajorVersion이 6이면 dwOsMinorVersion 매개 변수는 0 또는 1이어야 합니다.

 

반환 값

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

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

  • 호출자에게 파일을 작성하는 데 필요한 액세스 권한이 없으면 함수는 ERROR_ACCESS_DENIED 반환합니다.
  • 지정된 파일이 이미 있는 경우 함수는 ERROR_ALREADY_EXISTS 반환합니다.

설명

ORSaveHive 함수는 오프라인 레지스트리 하이브에 대한 변경 내용을 저장하는 데 사용해야 합니다. 파일에 하이브를 저장하기 위해 ORSaveHive 가 호출될 때까지 변경 내용은 유지되지 않습니다.

dwOsMajorVersion 및 dwOsMinorVersion 매개 변수는 함께 레지스트리 하이브 파일의 대상 형식을 지정합니다. 다음 표에는 최신 운영 체제 버전 번호가 요약됩니다.

운영 체제 버전 번호
Windows Server 2008 R2 6.1
Windows 7 6.1
Windows Server 2008 6.0
Windows Vista 6.0
Windows Server 2003 R2 5.2
Windows Server 2003 5.2
Windows XP Professional x64 Edition 5.2
Windows XP 5.1

 

GetVersionEx 함수를 사용하여 현재 운영 체제에 대한 정보를 검색합니다.

ORSaveHive 함수는 하이브를 파일에 쓰는 동안 레지스트리 하이브를 잠근 다음 파일을 닫고 잠금을 해제합니다. 레지스트리 하이브는 ORCloseHive 함수를 호출하여 닫을 때까지 메모리에 남아 있습니다. 열려 있는 동안 레지스트리 하이브를 추가로 변경할 수 있습니다. 그러나 이러한 변경 내용을 유지하려면 ORSaveHive 함수가 기존 파일을 덮어쓰지 않으므로 하이브를 새 파일에 저장해야 합니다.

ORSaveHive 함수를 사용하여 오프라인 레지스트리 하이브의 일부를 저장할 수 있습니다. Handle 매개 변수에 지정된 키는 지정된 키와 모든 하위 키로 구성된 hive의 루트 키가 됩니다.

요구 사항

요구 사항 값
재배포 가능 파일
 Windows 오프라인 레지스트리 라이브러리 버전 1.0 이상
헤더
Offreg.h
DLL
Offreg.dll

추가 정보

GetVersionEx

ORCloseHive

OROpenHive