(wdm.h) REG_QUERY_KEY_INFORMATION 结构

  • 项目

REG_QUERY_KEY_INFORMATION结构描述了要查询密钥的元数据。

语法

typedef struct _REG_QUERY_KEY_INFORMATION {
  PVOID                 Object;
  KEY_INFORMATION_CLASS KeyInformationClass;
  PVOID                 KeyInformation;
  ULONG                 Length;
  PULONG                ResultLength;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_QUERY_KEY_INFORMATION, *PREG_QUERY_KEY_INFORMATION;

成员

Object

指向要查询其元数据的项的注册表项对象的指针。

KeyInformationClass

KEY_INFORMATION_CLASS值，该值指示系统要返回的信息类型。

KeyInformation

指向缓冲区的指针，该缓冲区包含系统要返回的信息。 缓冲区的格式取决于 KeyInformationClass 的值。 有关详细信息，请参阅 KEY_INFORMATION_CLASS。

Length

指定 KeyInformation 缓冲区的大小（以字节为单位）。

ResultLength

指向从系统接收 (的变量的指针) KeyInformation 缓冲区中有效数据量（以字节为单位）。

CallContext

驱动程序的 RegistryCallback 例程可以提供的可选驱动程序定义的上下文信息。 此成员是针对 Windows Vista 和更高版本的 Windows 操作系统定义的。

ObjectContext

指向驱动程序定义的上下文信息的指针，驱动程序通过调用 CmSetCallbackObjectContext 与注册表对象相关联。 此成员是针对 Windows Vista 和更高版本的 Windows 操作系统定义的。

Reserved

此成员留待将来使用。 此成员是针对 Windows Vista 和更高版本的 Windows 操作系统定义的。

注解

每当线程尝试查询密钥的元数据时（例如，用户模式线程调用 RegQueryInfoKey 或驱动程序调用 ZwQueryKey 时），系统都会将此结构传递给 RegistryCallback 例程。

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

要求

要求 值
最低受支持的客户端 适用于 Microsoft Windows XP 和 Windows 操作系统的更高版本。
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）

另请参阅

CmSetCallbackObjectContext

RegistryCallback

ZwQueryKey