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

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

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

要求

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

另请参阅

CmSetCallbackObjectContext

CmUnRegisterCallback

RegistryCallback