REG_CREATE_KEY_INFORMATION结构(wdm.h)
过时。 从 Windows 7 开始,请改用此结构的 V1 版本 REG_CREATE_KEY_INFORMATION_V1。
REG_CREATE_KEY_INFORMATION 结构包含驱动程序 RegistryCallback 例程在正在创建的注册表项时可以使用的信息。
语法
typedef struct _REG_CREATE_KEY_INFORMATION {
PUNICODE_STRING CompleteName;
PVOID RootObject;
PVOID ObjectType;
ULONG CreateOptions;
PUNICODE_STRING Class;
PVOID SecurityDescriptor;
PVOID SecurityQualityOfService;
ACCESS_MASK DesiredAccess;
ACCESS_MASK GrantedAccess;
PULONG Disposition;
PVOID *ResultObject;
PVOID CallContext;
PVOID RootObjectContext;
PVOID Transaction;
PVOID Reserved;
} REG_CREATE_KEY_INFORMATION, REG_OPEN_KEY_INFORMATION, *PREG_CREATE_KEY_INFORMATION, *PREG_OPEN_KEY_INFORMATION;
成员
CompleteName
指向包含新注册表项路径的 UNICODE_STRING 结构的指针。 路径可以是绝对路径或相对路径。 如果路径是绝对路径,则此结构包含以“\”字符开头的完全限定路径。 对于绝对路径,RootObject 成员指定 \REGISTRY 键,这是注册表树的根目录。 如果路径是相对的,则路径以“\”以外的字符开头,并且相对于由 RootObject 成员指定的键。
RootObject
指向注册表项对象的指针,该对象充当由 CompleteName 成员指定的路径的根。
ObjectType
ObjectType 成员保留供内部使用。 驱动程序不得访问此成员。
CreateOptions
按位 OR 标志。 有关这些标志的详细信息,请参阅 ZwCreateKey 例程的 CreateOptions 参数。
Class
指向标识键对象类的 UNICODE_STRING 结构的指针。 有关此成员的详细信息,请参阅 ZwCreateKey 例程的 类 参数。
SecurityDescriptor
指向包含密钥对象安全信息的 SECURITY_DESCRIPTOR 结构的指针。
SecurityQualityOfService
指向 Winnt.h 中定义的 SECURITY_QUALITY_OF_SERVICE 结构的指针。
DesiredAccess
尝试创建注册表项的线程指定的访问掩码。
GrantedAccess
一个访问掩码,指示已授予尝试创建注册表项的线程的访问权限。 有关此成员的详细信息,请参阅“备注”。
Disposition
一个值,该值指示是否已创建注册表项。 有关此成员的详细信息,请参阅 ZwCreateKey 例程的 Disposition 参数以及以下“备注”部分。
ResultObject
指向接收表示所创建注册表项的键对象的地址的位置的指针。 有关此成员的详细信息,请参阅“备注”。
CallContext
驱动程序 RegistryCallback 例程可以提供的可选驱动程序定义的上下文信息。
RootObjectContext
指向驱动程序定义的上下文信息的指针,该驱动程序通过调用 CmSetCallbackObjectContext来关联注册表对象的路径根。
Transaction
指向尝试作的事务对象的指针。 如果此成员 NULL,则会在非事务上下文中执行该作。
Reserved
如果此成员为 1,则可以安全地将此结构强制转换为类型 REG_CREATE_KEY_INFORMATION_V1,其中包含其他参数。
言论
每当线程尝试创建密钥时,配置管理器都会将此结构传递给 RegistryCallback 例程,例如,当用户模式线程调用 RegCreateKey 或 RegCreateKeyEx 或驱动程序调用 ZwCreateKey时。
如果驱动程序的 RegistryCallback 例程返回 RegNtPreCreateKeyEx 通知STATUS_CALLBACK_BYPASS,驱动程序必须提供 GrantedAccess、Disposition和 ResultObject 值。
有关注册表筛选作的详细信息,请参阅 筛选注册表调用。
要求
要求 | 价值 |
---|---|
标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |