REG_QUERY_VALUE_KEY_INFORMATION结构(wdm.h)

REG_QUERY_VALUE_KEY_INFORMATION 结构包含有关正在查询的注册表项的值项的信息。

语法

typedef struct _REG_QUERY_VALUE_KEY_INFORMATION {
  PVOID                       Object;
  PUNICODE_STRING             ValueName;
  KEY_VALUE_INFORMATION_CLASS KeyValueInformationClass;
  PVOID                       KeyValueInformation;
  ULONG                       Length;
  PULONG                      ResultLength;
  PVOID                       CallContext;
  PVOID                       ObjectContext;
  PVOID                       Reserved;
} REG_QUERY_VALUE_KEY_INFORMATION, *PREG_QUERY_VALUE_KEY_INFORMATION;

成员

Object

指向要查询其值项的密钥的注册表项对象的指针。

ValueName

指向 UNICODE_STRING 结构的指针,该结构包含要检索其信息的值项的名称。

KeyValueInformationClass

指示系统返回的信息类型的 KEY_VALUE_INFORMATION_CLASS 值。

KeyValueInformation

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

Length

KeyValueInformation 缓冲区的大小(以字节为单位)。

ResultLength

指向一个变量的指针,该变量接收 KeyValueInformation 缓冲区中有效数据量(以字节为单位)。

CallContext

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

ObjectContext

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

Reserved

此成员保留供将来使用。 此成员是为 Windows Vista 和更高版本的 Windows作系统定义的。

言论

系统将此结构传递给 RegistryCallback 例程,每次线程尝试查询键的值项时(例如,当用户模式线程调用 RegQueryValueRegQueryValueEx 或驱动程序调用 ZwDeleteKey时)。

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

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的 Windows作系统上可用。
标头 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另请参阅

CmSetCallbackObjectContext

RegistryCallback

ZwDeleteKey

ZwQueryValueKey