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 例程,例如,当用户模式线程调用 RegCreateKeyRegCreateKeyEx 或驱动程序调用 ZwCreateKey时。

如果驱动程序的 RegistryCallback 例程返回 RegNtPreCreateKeyEx 通知STATUS_CALLBACK_BYPASS,驱动程序必须提供 GrantedAccessDispositionResultObject 值。

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

要求

要求 价值
标头 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)

另请参阅

REG_CREATE_KEY_INFORMATION_V1

REG_POST_OPERATION_INFORMATION

RegistryCallback

SECURITY_DESCRIPTOR

UNICODE_STRING

ZwCreateKey