Compartir a través de


Acerca de la biblioteca del Registro sin conexión

La biblioteca del Registro sin conexión se usa para modificar un subárbol del registro fuera del registro del sistema activo.

La biblioteca del Registro sin conexión está pensada para escenarios de actualización del Registro, como el mantenimiento de una imagen de sistema operativo. Las funciones del Registro sin conexión proporcionan las siguientes funcionalidades que no están disponibles con las funciones del Registro estándar:

  • Las funciones del Registro sin conexión se pueden usar para modificar un subárbol del Registro en cualquier formato de registro compatible. Las funciones del Registro estándar solo pueden realizar cambios en un subárbol de registro activo y los cambios deben ser compatibles con la versión de Windows que se ejecuta en el sistema.
  • La biblioteca del Registro sin conexión solo requiere acceso de lectura para abrir un archivo de Hive del Registro y el acceso de escritura para guardar el archivo. No se realizan otras comprobaciones de acceso en objetos del subárbol, lo que permite modificar el subárbol con privilegios de usuario estándar. Con las funciones del Registro estándar, cargar un subárbol en el registro activo es una operación con privilegios que requiere acceso administrativo.

Las funciones del Registro sin conexión no deben usarse como sustituto de las funciones del Registro del sistema por los siguientes motivos:

  • Es imposible compartir subárboles del Registro entre procesos mediante las funciones del Registro sin conexión.
  • Las funciones del Registro sin conexión usan un bloqueo simple que puede provocar una degradación grave del rendimiento de las aplicaciones multiproceso.
  • Los cambios realizados con las funciones del Registro sin conexión no se guardan hasta que se llama a la función ORSaveHive .

Las aplicaciones no deben usar las funciones del Registro sin conexión para omitir los requisitos de seguridad del registro del sistema. Para cargar un subárbol, una aplicación que se ejecuta sin los privilegios especiales requeridos por la función RegLoadKey puede usar la función RegLoadAppKey .

Windows Server 2003 y Windows XP: No se admite la función RegLoadAppKey .

Un subárbol del registro sin conexión es un subárbol del registro que se ha cargado en la memoria mediante las funciones del Registro sin conexión. Para crear un subárbol de registro sin conexión vacío, use la función ORCreateHive . Para modificar un subárbol del Registro existente, use la función RegSaveKey o RegSaveKeyEx para guardar un subárbol del registro del sistema activo en un archivo y, a continuación, use la función OROpenHive para abrir el archivo.

Las funciones ORCreateHive y OROpenHive devuelven un identificador a la clave raíz del subárbol del Registro sin conexión. Este identificador se puede usar como un identificador para cualquier otra clave del subárbol del Registro sin conexión con las siguientes excepciones: las funciones ORCreateKey y OROpenKey no se pueden usar para devolver un identificador a la clave raíz; La función ORCloseKey no se puede usar para cerrar la clave raíz; y la función ORDeleteKey no se pueden usar para eliminar la clave raíz. En todos estos casos, se produce un error en la función con ERROR_INVALID_PARAMETER.

Use la función ORCreateKey para agregar claves a un subárbol del Registro sin conexión abierto y la función ORSetValue para establecer los valores de las claves. La biblioteca del Registro sin conexión admite otras operaciones básicas del Registro, como enumerar, recuperar y eliminar claves y valores, y establecer atributos clave, como el comportamiento de seguridad y virtualización. Para obtener una lista de las funciones, consulte Funciones de la biblioteca del Registro sin conexión.

Para guardar los cambios realizados en un subárbol del Registro sin conexión abierto, use la función ORSaveHive para guardar el subárbol en un archivo. (Los cambios no se conservan a menos que se llame a ORSaveHive ). Después de guardar el subárbol, use la función ORCloseHive para cerrar el subárbol y liberar recursos asociados a él.

Un subárbol del Registro sin conexión solo se valida cuando se abre mediante la función OROpenHive . Si el subárbol está dañado, la operación simplemente produce un error; no se intenta reparar el subárbol. Las comprobaciones de acceso en los objetos del subárbol no se realizan hasta que el subárbol se carga en un registro activo con la función RegLoadKey .

Las funciones del Registro sin conexión no admiten las claves predefinidas.

Todas las cadenas de nombre de clave y valor que se pasan a las funciones del Registro sin conexión deben ser Unicode.

Library_Functions del Registro sin conexión