wdm.h) (REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION 结构

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 例程将收到 RegNtCallbackObjectContextCleanup 通知, (即没有对键对象的未完成句柄或指针引用) 。

为了响应此通知,例程应释放它为对象的上下文分配的任何资源。 当驱动程序调用 CmUnRegisterCallback 或驱动程序的 RegistryCallback 例程刚刚完成处理 RegNtPreKeyHandleClose 通知时,将发生 RegNtCallbackObjectContextCleanup 通知。

有关注册表筛选操作的详细信息,请参阅 筛选注册表调用

要求

要求
最低受支持的客户端 从 Windows Vista 开始可用。
标头 wdm.h(包括 Wdm.h、Ntddk.h、Ntifs.h)

另请参阅

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback