Función RegRestoreKeyW (winreg.h)

Artículo
11/20/2024

Lee la información del Registro en un archivo especificado y la copia sobre la clave especificada. Esta información del Registro puede estar en forma de clave y varios niveles de subclaves.

Las aplicaciones que realicen copias de seguridad o restaure el estado del sistema, incluidos los archivos del sistema y los subárboles del registro, deben usar el servicio de instantáneas de volumen de en lugar de las funciones del Registro.

Sintaxis

LSTATUS RegRestoreKeyW(
  [in] HKEY    hKey,
  [in] LPCWSTR lpFile,
  [in] DWORD   dwFlags
);

Parámetros

[in] hKey

Identificador de una clave del Registro abierta. Este identificador lo devuelve la función RegCreateKeyEx o RegOpenKeyEx. También puede ser una de las siguientes claves predefinidas:

HKEY_CLASSES_ROOTHKEY_CURRENT_CONFIGHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERS Cualquier información contenida en esta clave y sus claves descendientes se sobrescriben mediante la información del archivo al que apunta el parámetro lpFile.

[in] lpFile

Nombre del archivo con la información del Registro. Este archivo se crea normalmente mediante la función RegSaveKey.

[in] dwFlags

Marcas que indican cómo se van a restaurar la clave o las claves. Este parámetro puede ser uno de los siguientes valores.

Valor	Significado
REG_FORCE_RESTORE 0x00000008L	Si se especifica, la operación de restauración se ejecuta incluso si existen identificadores abiertos en la ubicación de la jerarquía del Registro a la que apunta el parámetro hKey .
REG_WHOLE_HIVE_VOLATILE 0x00000001L	Si se especifica, se crea un nuevo conjunto volátil (solo memoria) de información del Registro o subárbol. Si se especifica REG_WHOLE_HIVE_VOLATILE, la clave identificada por el parámetro hKey debe ser el valor de HKEY_USERS o HKEY_LOCAL_MACHINE.

Valor devuelto

Si la función se ejecuta correctamente, se ERROR_SUCCESS el valor devuelto.

Si se produce un error en la función, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error.

Observaciones

Hay dos formatos de archivo hive del Registro diferentes. Los subárboles del Registro creados en los sistemas operativos actuales normalmente no se pueden cargar en los anteriores.

Si se abren subclaves del parámetro hKey, se produce un error en RegRestoreKey.

El proceso de llamada debe tener los privilegios SE_RESTORE_NAME y SE_BACKUP_NAME en el equipo en el que reside el registro. Para obtener más información, vea En ejecución con privilegios especiales.

Esta función reemplaza las claves y los valores debajo de la clave especificada por las claves y los valores que son subsidiarias a la clave de nivel superior del archivo, independientemente del nombre de la clave de nivel superior del archivo. Por ejemplo, hKey podría identificar una clave A con subclaves B y C, mientras que el parámetro lpFile especifica un archivo que contiene la clave X con subclaves Y y Z. Después de una llamada a RegRestoreKey, el registro contendrá la clave A con subclaves Y y Z. Las entradas de valor de A se reemplazarían por las entradas de valor de X.

La nueva información del archivo especificado por lpFile sobrescribe el contenido de la clave especificada por el parámetro hKey, excepto el nombre de clave.

Si hKey representa una clave en un equipo remoto, la ruta de acceso descrita por lpFile es relativa al equipo remoto.

Nota

El encabezado winreg.h define RegRestoreKey como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winreg.h (incluya Windows.h)
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll