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) |