지정된 레지스트리 하이브 파일을 메모리에 로드하고 하이브의 유효성을 검사합니다.
구문
DWORD OROpenHive(
_In_ PCWSTR lpHivePath,
_Out_ PORHKEY phkResult
);
매개 변수
-
lpHivePath [in]
-
메모리에 로드할 레지스트리 하이브 파일의 이름을 지정하는 유니코드 문자열에 대한 포인터입니다. ORSaveHive 함수로 저장되었거나 RegSaveKey 또는 RegSaveKeyEx 함수를 사용하여 만든 하이브 파일일 수 있습니다. 파일 크기는 4GB 미만이어야 하며 호출자는 파일에 대한 FILE_READ_DATA 액세스 권한이 있어야 합니다. 자세한 내용은 파일 보안 및 액세스 권한을 참조하세요.
-
phkResult [out]
-
로드된 오프라인 레지스트리 하이브의 루트 키에 대한 핸들을 수신하는 변수에 대한 포인터입니다. 레지스트리 하이브 파일을 열 수 없거나 유효성 검사가 실패하면 함수는 이 매개 변수를 NULL로 설정합니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 Winerror.h에 정의된 0이 아닌 오류 코드입니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다. 가능한 오류 코드에는 다음이 포함됩니다.
- 파일이 비어 있거나 크기가 4GB보다 크면 함수는 ERROR_BADDB 반환합니다.
- 호출자에게 파일을 여는 데 필요한 액세스 권한이 없는 경우 함수는 ERROR_ACCESS_DENIED 반환합니다.
- 레지스트리 하이브가 유효성 검사에 실패하면 함수는 ERROR_NOT_REGISTRY_FILE 반환합니다.
설명
OROpenHive 함수는 레지스트리 하이브의 유효성을 검사하는 유일한 오프라인 레지스트리 함수입니다. 유효성 검사에 실패하면 하이브를 복구하려고 시도하지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 재배포 가능 파일 |
Windows 오프라인 레지스트리 라이브러리 버전 1.0 이상 |
| 헤더 |
|
| DLL |
|
추가 정보