REG_RESTORE_KEY_INFORMATION 구조체(wdm.h)

REG_RESTORE_KEY_INFORMATION 구조에는 복원할 레지스트리 키에 대한 정보가 포함됩니다.

구문

typedef struct _REG_RESTORE_KEY_INFORMATION {
  PVOID  Object;
  HANDLE FileHandle;
  ULONG  Flags;
  PVOID  CallContext;
  PVOID  ObjectContext;
  PVOID  Reserved;
} REG_RESTORE_KEY_INFORMATION, *PREG_RESTORE_KEY_INFORMATION;

멤버

Object

복원할 키에 대한 레지스트리 키 개체에 대한 포인터입니다.

FileHandle

하이브를 복원할 파일에 대한 핸들입니다.

Flags

REG_FORCE_RESTORE

0x00000008L

지정된 경우 열려 있는 핸들이 hKey 매개 변수가 가리키는 레지스트리 계층 구조의 위치 또는 아래에 있는 경우에도 복원 작업이 실행됩니다.

REG_WHOLE_HIVE_VOLATILE

0x00000001L

지정된 경우 레지스트리 정보 또는 하이브의 새로운 휘발성(메모리 전용) 집합이 만들어집니다. REG_WHOLE_HIVE_VOLATILE 지정한 경우 hKey 매개 변수로 식별되는 키는 HKEY_USERS 또는 HKEY_LOCAL_MACHINE 값이어야 합니다.

REG_REFRESH_HIVE

0x00000002

설정된 경우 hKey 매개 변수가 가리키는 하위 트리의 위치는 마지막 플러시 직후의 상태로 복원됩니다. 하위 트리는 지연 플러시되어서는 안 됩니다(이 매개 변수의 값으로 지정된 REG_NO_LAZY_FLUSH RegRestoreKey 를 호출하여). 호출자에게는 신뢰할 수 있는 컴퓨팅 기반(TCB) 권한이 있어야 합니다. hKey 매개 변수가 참조하는 핸들은 하위 트리의 루트를 가리킵니다.

CallContext

드라이버의 RegistryCallback 루틴에서 제공할 수 있는 선택적 드라이버 정의 컨텍스트 정보입니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.

ObjectContext

드라이버가 CmSetCallbackObjectContext를 호출하여 레지스트리 개체와 연결한 드라이버 정의 컨텍스트 정보에 대한 포인터입니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.

Reserved

이 멤버는 나중에 사용하도록 예약되어 있습니다. 이 멤버는 Windows Vista 이상 버전의 Windows 운영 체제에 대해 정의됩니다.

설명

REG_REFRESH_HIVE 플래그는 불투명하며 필터가 변경하려고 시도하면 안 됩니다.

레지스트리 필터링 작업에 대한 자세한 내용은 레지스트리 호출 필터링을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista SP2 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)

추가 정보

CmSetCallbackObjectContext

RegistryCallback