ORSetVirtualFlags 함수

오프라인 레지스트리 하이브의 지정된 열린 레지스트리 키에 가상화 플래그를 설정합니다.

구문

DWORD ORSetVirtualFlags(
  _In_ ORHKEY Handle,
  _In_ DWORD  dwFlags
);

매개 변수

핸들 [in]

오프라인 레지스트리 하이브에서 열린 레지스트리 키에 대한 핸들입니다.

dwFlags [in]

이 매개 변수는 가상화된 하이브의 키에서 만들기 또는 열기 작업이 실패할 때 레지스트리의 동작을 제어합니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

값	의미
REG_KEY_DONT_SILENT_FAIL 4	이 플래그가 설정되고 가상화가 사용하도록 설정된 키에서 열기 작업이 실패하는 경우 레지스트리는 키를 다시 열려고 시도하지 않습니다. 이 플래그가 명확하면 레지스트리는 MAXIMUM_ALLOWED 액세스 권한으로 키를 다시 열려고 시도합니다.
REG_KEY_DONT_VIRTUALIZE 2	호출자에게 부모 키에 대한 KEY_CREATE_SUB_KEY 권한이 없으므로 이 플래그가 설정되고 키 만들기 작업이 실패하면 레지스트리가 만들기 작업에 실패합니다. 이 플래그가 명확하면 레지스트리는 가상 저장소에 키를 만들려고 시도합니다. 호출자는 부모 키에 대한 KEY_READ 권한이 있어야 합니다.
REG_KEY_RECURSE_FLAG 8	이 플래그를 설정하면 레지스트리 가상화 플래그가 부모 키에서 전파됩니다. 이 플래그가 명확하면 레지스트리 가상화 플래그가 전파되지 않습니다.

 

반환 값

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

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

설명

레지스트리 가상화는 전역 영향을 주는 레지스트리 쓰기 작업을 사용자별 위치로 리디렉션할 수 있도록 하는 임시 애플리케이션 호환성 기술입니다. 이 리디렉션은 레지스트리에서 읽거나 레지스트리에 쓰는 애플리케이션에 투명합니다.

레지스트리 가상화는 Windows Vista부터 지원됩니다. 그러나 더 많은 애플리케이션이 Windows Vista와 호환되므로 Microsoft는 이후 버전의 Windows 운영 체제에서 제거하려고 합니다. 따라서 애플리케이션은 시스템의 레지스트리 가상화 동작에 의존해서는 안 됩니다.

레지스트리 가상화는 다음에 대해서만 사용하도록 설정됩니다.

• 32비트 대화형 프로세스
• HKEY_LOCAL_MACHINE\Software 키
• 관리자가 쓸 수 있는 키

자세한 내용은 레지스트리 가상화를 참조하세요.

요구 사항

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

추가 정보

ORGetVirtualFlags

레지스트리 가상화