REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION 结构 (wdm.h)

  • 项目

REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION 结构描述正在为键检索的多个值条目。

语法

typedef struct _REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION {
  PVOID            Object;
  PKEY_VALUE_ENTRY ValueEntries;
  ULONG            EntryCount;
  PVOID            ValueBuffer;
  PULONG           BufferLength;
  PULONG           RequiredBufferLength;
  PVOID            CallContext;
  PVOID            ObjectContext;
  PVOID            Reserved;
} REG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION, *PREG_QUERY_MULTIPLE_VALUE_KEY_INFORMATION;

成员

Object

指向要检索其值项的项的注册表项对象的指针。

ValueEntries

指向 KEY_VALUE_ENTRY 结构的数组的指针，其中一个用于检索到的每个值条目。

EntryCount

ValueEntries 数组中的条目数。

ValueBuffer

指向从系统接收 (的缓冲区的指针，) ValueEntries 数组指定的所有值条目的数据。

BufferLength

指向变量的指针，该变量包含 ValueBuffer 缓冲区的长度（以字节为单位）。

RequiredBufferLength

指向从系统接收 (的变量的指针) 保存 ValueEntries 数组指定的所有值条目的数据所需的字节数。 此成员可以为 NULL。

CallContext

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

ObjectContext

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

Reserved

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

注解

每次线程尝试一次检索一个密钥的多个值条目时，系统都会将此结构传递给 RegistryCallback 例程，例如，当用户模式线程调用 RegQueryMultipleValues 时。

ValueEntries 数组中的每个KEY_VALUE_ENTRY结构都描述 ValueBuffer 缓冲区中的一个值条目。 具体而言，KEY_VALUE_ENTRY 的 DataOffset 成员包含 ValueBuffer 中值条目的数据开始位置的偏移量，DataLength 成员包含该值条目的数据长度（以字节为单位）。

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

要求

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

另请参阅

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback