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