REG_SET_KEY_SECURITY_INFORMATION structure (wdm.h)

The REG_SET_KEY_SECURITY_INFORMATION structure specifies security information for a registry key object.

Syntax

typedef struct _REG_SET_KEY_SECURITY_INFORMATION {
  PVOID                 Object;
  PSECURITY_INFORMATION SecurityInformation;
  PSECURITY_DESCRIPTOR  SecurityDescriptor;
  PVOID                 CallContext;
  PVOID                 ObjectContext;
  PVOID                 Reserved;
} REG_SET_KEY_SECURITY_INFORMATION, *PREG_SET_KEY_SECURITY_INFORMATION;

Members

Object

A pointer to the registry key object for the key whose security information is being set.

SecurityInformation

A pointer to a SECURITY_INFORMATION-typed variable that identifies the type of security information that is being set.

SecurityDescriptor

A pointer to a SECURITY_DESCRIPTOR structure that contains security information for the key object.

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 the REG_SET_KEY_SECURITY_INFORMATION structure to the RegistryCallback routine every time a thread attempts to set a key's security information—for example, when a driver calls ZwSetSecurityObject.

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

Requirements

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

See also

CmSetCallbackObjectContext

RegistryCallback

SECURITY_DESCRIPTOR

SECURITY_INFORMATION

ZwSetSecurityObject