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

指向注册表项对象的指针。 此对象表示正在卸载的 hive 的根键。

UserEvent

指向事件对象的指针。

CallContext

驱动程序 RegistryCallback 例程可以提供的可选驱动程序定义的上下文信息。 此成员从 Windows Vista 开始定义。

ObjectContext

通过调用 CmSetCallbackObjectContext,指向驱动程序与注册表对象关联的驱动程序定义的上下文信息的指针。 此成员从 Windows Vista 开始定义。

Reserved

此成员保留供将来使用。 此成员从 Windows Vista 开始定义。

言论

此结构由 RegistryCallback 例程使用。 当 RegistryCallback 例程的 Argument1 参数 RegNtPreUnloadKey时,Argument2 参数是指向 REG_UNLOAD_KEY_INFORMATION 结构的指针。

每当线程尝试卸载密钥时,作系统都会将 REG_UNLOAD_KEY_INFORMATION 结构传递给 RegistryCallback 例程,例如,当用户模式线程调用 RegUnloadKey 函数时。 为了响应 RegNtPreUnloadKey 通知,RegistryCallback 例程应释放以前分配用于 hive 的驱动程序在卸载 hive 之前分配的任何资源。

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

要求

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

另请参阅

CmSetCallbackObjectContext

RegistryCallback