wdm.h) (REG_CREATE_KEY_INFORMATION 结构
已过时。 从 Windows 7 开始，请改用 REG_CREATE_KEY_INFORMATION_V1，即此结构的 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 例程的 Class 参数。
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类型。
注解
每当线程尝试创建键时（例如，当用户模式线程调用 RegCreateKey 或 RegCreateKeyEx 或驱动程序调用 ZwCreateKey 时），配置管理器都会将此结构传递给 RegistryCallback 例程。
如果驱动程序的 RegistryCallback 例程返回 RegNtPreCreateKeyEx 通知的STATUS_CALLBACK_BYPASS，则驱动程序必须提供 GrantedAccess、 Disposition 和 ResultObject 值。
有关注册表筛选操作的详细信息，请参阅 筛选注册表调用。
要求
| 要求 | 值 |
|---|---|
| 标头 | wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |