Función ORSaveHive

Escribe el subárbol del Registro sin conexión especificado en un archivo.

Sintaxis

DWORD ORSaveHive(
  _In_ ORHKEY Handle,
  _In_ PCWSTR lpHivePath,
  _In_ DWORD  dwOsMajorVersion,
  _In_ DWORD  dwOsMinorVersion
);

Parámetros

Identificador [in]

Identificador del subárbol del Registro sin conexión que se va a guardar.

lpHivePath [in]

Puntero a una cadena Unicode que especifica el nombre del archivo de subárbol del Registro. No puede ser el nombre de un archivo existente.

dwOsMajorVersion [in]

Número de versión principal del sistema operativo. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
5	Si dwOsMinorVersion es 1, el sistema operativo es Windows XP. Si dwOsMinorVersion es 2, el sistema operativo es Windows Server 2003 R2, Windows Server 2003 o Windows XP Professional x64 Edition.
6	Si dwOsMinorVersion es 0, el sistema operativo es Windows Server 2008 o Windows Vista. Si dwOsMinorVersion es 1, el sistema operativo es Windows Server 2008 R2 o Windows 7.

 

dwOsMinorVersion [in]

Número de versión secundaria del sistema operativo. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
0	Si dwOsMajorVersion es 6, el sistema operativo es Windows Server 2008 o Windows Vista.
1	Si dwOsMajorVersion es 5, el sistema operativo es Windows XP. Si dwOsMajorVersion es 6, el sistema operativo es Windows Server 2008 R2 o Windows 7.
2	Si dwOsMajorVersion es 5, el sistema operativo es Windows Server 2003 R2, Windows Server 2003 o Windows XP Professional x64 Edition. Si dwOsMajorVersion es 6, el parámetro dwOsMinorVersion debe ser 0 o 1.

 

Valor devuelto

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

Si la función no se ejecuta correctamente, 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. Entre los posibles códigos de error se incluyen los siguientes:

• Si el autor de la llamada no tiene los derechos de acceso necesarios para escribir el archivo, la función devuelve ERROR_ACCESS_DENIED.
• Si el archivo especificado ya existe, la función devuelve ERROR_ALREADY_EXISTS.

Comentarios

La función ORSaveHive debe usarse para guardar los cambios realizados en un subárbol del Registro sin conexión. Los cambios no se conservan hasta que se llama a ORSaveHive para guardar el subárbol en un archivo.

Los parámetros dwOsMajorVersion y dwOsMinorVersion especifican juntos el formato de destino del archivo del subárbol del Registro. En la tabla siguiente se resumen los números de versión del sistema operativo más recientes.

Sistema operativo	Número de la versión
Windows Server 2008 R2	6.1
Windows 7	6.1
Windows Server 2008	6,0
Windows Vista	6,0
Windows Server 2003 R2	5.2
Windows Server 2003	5.2
Windows XP Professional x64 Edition	5.2
Windows XP	5,1

 

Use la función GetVersionEx para recuperar información sobre el sistema operativo actual.

La función ORSaveHive bloquea el subárbol del Registro mientras escribe el subárbol en el archivo y, a continuación, cierra el archivo y libera el bloqueo. El subárbol del Registro permanece en memoria hasta que se cierra mediante una llamada a la función ORCloseHive . Es posible realizar más cambios en el subárbol del Registro mientras está abierto; Sin embargo, para conservar estos cambios, el subárbol debe guardarse en un nuevo archivo, ya que la función ORSaveHive no sobrescribirá un archivo existente.

La función ORSaveHive se puede usar para guardar parte del subárbol del Registro sin conexión. La clave especificada en el parámetro Handle se convierte en la clave raíz de un subárbol que consta de la clave especificada y de todas sus subclaves.

Requisitos

Requisito	Value
Redistribuible	Biblioteca del Registro sin conexión de Windows versión 1.0 o posterior
Encabezado	Offreg.h
Archivo DLL	Offreg.dll

Consulte también

GetVersionEx

ORCloseHive

OROpenHive