estructura REG_CREATE_KEY_INFORMATION (wdm.h)

Artículo
03/08/2023

Obsoleto. A partir de Windows 7, use REG_CREATE_KEY_INFORMATION_V1, la versión V1 de esta estructura en su lugar.

La estructura de REG_CREATE_KEY_INFORMATION contiene información que la rutina RegistryCallback de un controlador puede usar cuando se crea una clave del Registro.

Sintaxis

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;

Miembros

CompleteName

Puntero a una estructura UNICODE_STRING que contiene la ruta de acceso de la nueva clave del Registro. La ruta de acceso puede ser absoluta o relativa. Si la ruta de acceso es absoluta, esta estructura contiene una ruta de acceso completa que comienza con el carácter "\". Para una ruta de acceso absoluta, el miembro RootObject especifica la clave \REGISTRY , que es el directorio raíz del árbol del Registro. Si la ruta de acceso es relativa, la ruta de acceso comienza con un carácter distinto de "\" y es relativa a la clave especificada por el miembro RootObject .

RootObject

Puntero al objeto de clave del Registro que actúa como raíz para la ruta de acceso especificada por el miembro CompleteName .

ObjectType

El miembro ObjectType está reservado para uso interno. Los controladores no deben tener acceso a este miembro.

CreateOptions

OR bit a bit de marcas. Para obtener más información sobre estas marcas, vea el parámetro CreateOptions de la rutina ZwCreateKey .

Class

Puntero a una estructura de UNICODE_STRING que identifica la clase de objeto de la clave. Para obtener más información sobre este miembro, vea el parámetro Class de la rutina ZwCreateKey .

SecurityDescriptor

Puntero a una estructura SECURITY_DESCRIPTOR que contiene información de seguridad para el objeto de clave.

SecurityQualityOfService

Puntero a una estructura SECURITY_QUALITY_OF_SERVICE , que se define en Winnt.h.

DesiredAccess

Máscara de acceso especificada por el subproceso que intenta crear la clave del Registro.

GrantedAccess

Máscara de acceso que indica los derechos de acceso que se han concedido al subproceso que intenta crear la clave del Registro. Para obtener más información sobre este miembro, vea Comentarios.

Disposition

Valor que indica si se creó la clave del Registro. Para obtener más información sobre este miembro, vea el parámetro Disposition de la rutina ZwCreateKey y la siguiente sección Comentarios.

ResultObject

Puntero a una ubicación que recibe la dirección del objeto de clave que representa la clave del Registro creada. Para obtener más información sobre este miembro, vea Comentarios.

CallContext

Información de contexto opcional definida por el controlador que puede proporcionar la rutina RegistryCallback del controlador.

RootObjectContext

Puntero a una información de contexto definida por el controlador que el controlador ha asociado a la raíz de la ruta de acceso del objeto del Registro mediante una llamada a CmSetCallbackObjectContext.

Transaction

Puntero a un objeto de transacción en el que se intenta realizar la operación. Si este miembro es NULL, la operación se realiza en contexto no transaccional.

Reserved

Si este miembro es 1, es seguro convertir esta estructura en el tipo REG_CREATE_KEY_INFORMATION_V1, que contiene parámetros adicionales.

Comentarios

El administrador de configuración pasa esta estructura a la rutina RegistryCallback cada vez que un subproceso intenta crear una clave, por ejemplo, cuando un subproceso en modo de usuario llama a RegCreateKey o RegCreateKeyEx o cuando un controlador llama a ZwCreateKey.

Si la rutina RegistryCallback del controlador devuelve STATUS_CALLBACK_BYPASS para una notificación RegNtPreCreateKeyEx , el controlador debe proporcionar los valores GrantedAccess, Disposition y ResultObject .

Para obtener más información sobre las operaciones de filtrado del Registro, consulte Filtrado de llamadas del Registro.