REG_SET_VALUE_KEY_INFORMATION 结构 (wdm.h)

  • 项目

REG_SET_VALUE_KEY_INFORMATION 结构描述注册表项的值条目的新设置。

语法

typedef struct _REG_SET_VALUE_KEY_INFORMATION {
  PVOID           Object;
  PUNICODE_STRING ValueName;
  ULONG           TitleIndex;
  ULONG           Type;
  PVOID           Data;
  ULONG           DataSize;
  PVOID           CallContext;
  PVOID           ObjectContext;
  PVOID           Reserved;
} REG_SET_VALUE_KEY_INFORMATION, *PREG_SET_VALUE_KEY_INFORMATION;

成员

Object

指向即将更改其值项的项的注册表项对象的指针。

ValueName

指向 UNICODE_STRING 结构的指针，该结构包含要更改的值条目的名称。

TitleIndex

预留给系统使用。 驱动程序应忽略此成员。

Type

即将写入的数据类型。 有关此成员的可能值的详细信息，请参阅 ZwSetValueKey 的 Type 参数。

Data

指向包含要写入的数据的缓冲区的指针。 缓冲区的格式取决于 Type 的值。 有关详细信息，请参阅 ZwSetValueKey。

DataSize

数据缓冲区的大小（以字节为单位）。

CallContext

驱动程序的 RegistryCallback 例程可以提供的可选驱动程序定义的上下文信息。 此成员是为 Windows Vista 和更高版本的 Windows 操作系统定义的。

ObjectContext

指向驱动程序定义的上下文信息的指针，驱动程序通过调用 CmSetCallbackObjectContext 与注册表对象相关联。 此成员是为 Windows Vista 和更高版本的 Windows 操作系统定义的。

Reserved

此成员留待将来使用。 此成员是为 Windows Vista 和更高版本的 Windows 操作系统定义的。

注解

每当线程尝试为键设置值项时（例如，当用户模式线程调用 RegSetValue 或 RegSetValueEx 或驱动程序调用 ZwSetValueKey 时），系统都会将此结构传递给 RegistryCallback 例程。

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

要求

要求 值
最低受支持的客户端 在 Microsoft Windows XP 和更高版本的 Windows 操作系统上可用。
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）

另请参阅

CmSetCallbackObjectContext

RegistryCallback

ZwSetValueKey