REG_ENUMERATE_KEY_INFORMATION结构 (wdm.h)
REG_ENUMERATE_KEY_INFORMATION 结构描述要枚举其子项的键的一个子项。
语法
typedef struct _REG_ENUMERATE_KEY_INFORMATION {
PVOID Object;
ULONG Index;
KEY_INFORMATION_CLASS KeyInformationClass;
PVOID KeyInformation;
ULONG Length;
PULONG ResultLength;
PVOID CallContext;
PVOID ObjectContext;
PVOID Reserved;
} REG_ENUMERATE_KEY_INFORMATION, *PREG_ENUMERATE_KEY_INFORMATION;
成员
Object
指向要枚举其子项的密钥的注册表项对象的指针。
Index
键中子项的从零开始的索引。
KeyInformationClass
KEY_INFORMATION_CLASS 值,该值指示系统在 KeyInformation 缓冲区中要返回的信息类型。
KeyInformation
指向包含系统要返回的信息的缓冲区的指针。 缓冲区的格式取决于 KeyInformationClass的值。 有关详细信息,请参阅 KEY_INFORMATION_CLASS。
Length
KeyInformation 缓冲区的大小(以字节为单位)。
ResultLength
指向 ULONG 的指针,该 ULONG 接收 KeyInformation 缓冲区中的有效数据量(以字节为单位)。
CallContext
驱动程序 RegistryCallback 例程可以提供的可选驱动程序定义的上下文信息。 此成员是为 Windows Vista 和更高版本的 Windows作系统定义的。
ObjectContext
通过调用 CmSetCallbackObjectContext,指向驱动程序与注册表对象关联的驱动程序定义的上下文信息的指针。 此成员是为 Windows Vista 和更高版本的 Windows作系统定义的。
Reserved
此成员保留供将来使用。 此成员是为 Windows Vista 和更高版本的 Windows作系统定义的。
言论
每当线程尝试枚举键的子项时,系统都会将此结构传递给 RegistryCallback 例程,例如,当用户模式线程 RegEnumKey 或 RegEnumKeyEx 或驱动程序调用 ZwEnumerateKey时。
有关注册表筛选作的详细信息,请参阅 筛选注册表调用。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Microsoft Windows XP 及更高版本的 Windows作系统上可用。 |
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |