오프라인 레지스트리 하이브에서 지정된 레지스트리 키를 엽니다.
구문
DWORD OROpenKey(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpSubKeyName,
_Out_ PORHKEY phkResult
);
매개 변수
-
핸들 [in]
-
오프라인 레지스트리 하이브에서 열린 레지스트리 키에 대한 핸들입니다.
-
lpSubKeyName [in, optional]
-
열 레지스트리 키의 이름을 포함하는 UNICODE 문자열에 대한 포인터입니다. 이 키는 Handle 매개 변수로 식별되는 키의 하위 키여야 합니다.
키 이름은 대/소문자를 구분하지 않습니다.
이 매개 변수가 NULL 이거나 빈 문자열에 대한 포인터인 경우 함수는 전달된 것과 동일한 핸들을 반환합니다. Handle 매개 변수로 지정된 키가 하이브의 루트 키인 경우 함수는 ERROR_INVALID_PARAMETER 반환합니다.
자세한 내용은 레지스트리 요소 크기 제한을 참조하세요.
-
phkResult [out]
-
열린 키에 대한 핸들을 수신하는 변수에 대한 포인터입니다. ORCloseKey 함수를 사용하여 핸들 사용을 완료한 후 키를 닫습니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 Winerror.h에 정의된 0이 아닌 오류 코드입니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다.
반환할 핸들이 하이브의 루트 키에 대한 핸들이면 함수는 ERROR_INVALID_PARAMETER 반환합니다.
지정된 키가 삭제된 것으로 표시되면 이 함수는 ERROR_KEY_DELETED 반환합니다.
설명
OROpenKey 함수는 오프라인 레지스트리 하이브에서 루트 키를 여는 데 사용할 수 없습니다. 하이브의 루트 키에 대한 핸들을 가져오려면 OROpenHive 함수를 사용하여 하이브를 메모리에 로드합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 재배포 가능 파일 |
Windows 오프라인 레지스트리 라이브러리 버전 1.0 이상 |
| 헤더 |
|
| DLL |
|
추가 정보