REG_SET_VALUE_KEY_INFORMATION structure (wdm.h)

The REG_SET_VALUE_KEY_INFORMATION structure describes a new setting for a registry key's value entry.

Syntax

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;

Members

Object

A pointer to the registry key object for the key whose value entry is about to be changed.

ValueName

A pointer to a UNICODE_STRING structure that contains the name of the value entry about to be changed.

TitleIndex

Reserved for system use. Drivers should ignore this member.

Type

The type of data that is about to be written. For more information about the possible values for this member, see the Type parameter of ZwSetValueKey.

Data

A pointer to a buffer that contains the data about to be written. The format of the buffer depends on the value of Type. For more information, see ZwSetValueKey.

DataSize

The size, in bytes, of the Data buffer.

CallContext

Optional driver-defined context information that the driver's RegistryCallback routine can supply. This member is defined for Windows Vista and later versions of the Windows operating system.

ObjectContext

A pointer to driver-defined context information that the driver has associated with a registry object by calling CmSetCallbackObjectContext. This member is defined for Windows Vista and later versions of the Windows operating system.

Reserved

This member is reserved for future use. This member is defined for Windows Vista and later versions of the Windows operating system.

Remarks

The system passes this structure to a RegistryCallback routine every time a thread attempts to set a value entry for a key—for example, when a user-mode thread calls RegSetValue or RegSetValueEx or when a driver calls ZwSetValueKey.

For more information about registry filtering operations, see Filtering Registry Calls.

Requirements

Requirement	Value
Minimum supported client	Available on Microsoft Windows XP and later versions of the Windows operating system.
Header	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

See also

CmSetCallbackObjectContext

RegistryCallback

ZwSetValueKey