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_ENTRYDataOffset 成员包含 ValueBuffer 中的偏移量,其中该值项的数据开始,DataLength 成员包含该值条目的数据长度(以字节为单位)。

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

要求

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

另请参阅

CmSetCallbackObjectContext

KEY_VALUE_ENTRY

RegistryCallback