REG_UNLOAD_KEY_INFORMATION 구조체(wdm.h)

  • 아티클

REG_UNLOAD_KEY_INFORMATION 구조에는 레지스트리 하이브가 언로드될 때 드라이버의 RegistryCallback 루틴에서 사용할 수 있는 정보가 포함되어 있습니다.

구문

typedef struct _REG_UNLOAD_KEY_INFORMATION {
  PVOID Object;
  PVOID UserEvent;
  PVOID CallContext;
  PVOID ObjectContext;
  PVOID Reserved;
} REG_UNLOAD_KEY_INFORMATION, *PREG_UNLOAD_KEY_INFORMATION;

멤버

Object

레지스트리 키 개체에 대한 포인터입니다. 이 개체는 언로드 중인 하이브의 루트 키를 나타냅니다.

UserEvent

이벤트 개체에 대한 포인터입니다.

CallContext

드라이버의 RegistryCallback 루틴에서 제공할 수 있는 선택적 드라이버 정의 컨텍스트 정보입니다. 이 멤버는 Windows Vista부터 정의됩니다.

ObjectContext

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

Reserved

이 멤버는 나중에 사용하도록 예약되어 있습니다. 이 멤버는 Windows Vista부터 정의됩니다.

설명

이 구조체는 RegistryCallback 루틴에서 사용됩니다. RegistryCallback 루틴에 대한 Argument1 매개 변수가 RegNtPreUnloadKey인 경우 Argument2 매개 변수는 REG_UNLOAD_KEY_INFORMATION 구조체에 대한 포인터입니다.

운영 체제는 스레드가 키를 언로드하려고 할 때마다(예: 사용자 모드 스레드가 RegUnloadKey 함수를 호출할 때) REG_UNLOAD_KEY_INFORMATION 구조를 RegistryCallback 루틴에 전달합니다. RegNtPreUnloadKey 알림에 대한 응답으로 RegistryCallback 루틴은 하이브가 언로드되기 전에 이전에 하이브에 사용하기 위해 드라이버가 할당한 모든 리소스를 해제해야 합니다.

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista부터 사용할 수 있습니다.
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)

추가 정보

CmSetCallbackObjectContext

RegistryCallback