REG_QUERY_KEY_NAME structure (wdm.h)

The REG_QUERY_KEY_NAME structure describes the full registry key name of an object being queried.

Syntax

typedef struct _REG_QUERY_KEY_NAME {
  PVOID                    Object;
  POBJECT_NAME_INFORMATION ObjectNameInfo;
  ULONG                    Length;
  PULONG                   ReturnLength;
  PVOID                    CallContext;
  PVOID                    ObjectContext;
  PVOID                    Reserved;
} REG_QUERY_KEY_NAME, *PREG_QUERY_KEY_NAME;

Members

Object

A pointer to the registry key object for the key whose metadata is about to be queried.

ObjectNameInfo

A pointer to an OBJECT_NAME_INFORMATION structure (see wdm.h) that contains the full registry key name to be returned by the system, as a Unicode string.

Length

Specifies the size, in bytes, of the ObjectNameInfo buffer.

ReturnLength

CallContext

Optional driver-defined context information that the driver's RegistryCallback routine can supply.

ObjectContext

A pointer to driver-defined context information that the driver has associated with a registry object by calling CmSetCallbackObjectContext. It contains the key context for the key that is being queried.

Reserved

This member is reserved for future use.

Remarks

The system passes this structure to the RegistryCallback routine every time a thread attempts to query the full name of the registry key.

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

Requirements

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

See also

REG_NOTIFY_CLASS

RegistryCallback