REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION 구조체(wdm.h)

  • 아티클

REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION 구조에는 드라이버의 RegistryCallback 루틴이 레지스트리 개체와 연결된 컨텍스트에 대해 드라이버가 이전에 할당한 리소스를 해제하는 데 사용할 수 있는 정보가 포함되어 있습니다.

구문

typedef struct _REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION {
  PVOID Object;
  PVOID ObjectContext;
  PVOID Reserved;
} REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION, *PREG_CALLBACK_CONTEXT_CLEANUP_INFORMATION;

멤버

Object

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

ObjectContext

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

Reserved

이 멤버는 나중에 사용하도록 예약되어 있습니다.

설명

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

드라이버의 RegistryCallback 루틴은 키 개체의 참조 수가 0으로 떨어지면 RegNtCallbackObjectContextCleanup 알림을 받습니다(즉, 키 개체에 대한 미해결 핸들이나 포인터 참조가 없음).

이 알림에 대한 응답으로 루틴은 개체의 컨텍스트에 할당된 모든 리소스를 해제해야 합니다. RegNtCallbackObjectContextCleanup 알림은 드라이버가 CmUnRegisterCallback을 호출했거나 드라이버의 RegistryCallback 루틴이 RegNtPreKeyHandleClose 알림 처리를 방금 완료한 경우에 발생합니다.

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

요구 사항

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

추가 정보

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback