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）

另请参阅

REG_CREATE_KEY_INFORMATION_V1

REG_POST_OPERATION_INFORMATION

RegistryCallback

SECURITY_DESCRIPTOR

UNICODE_STRING

ZwCreateKey