Função ORSaveHive

  • Artigo

Grava o hive do registro offline especificado em um arquivo.

Sintaxe

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

Parâmetros

Manipular [in]

Um identificador para o hive do registro offline a ser salvo.

lpHivePath [in]

Um ponteiro para uma cadeia de caracteres Unicode que especifica o nome do arquivo hive do registro. Não pode ser o nome de um arquivo existente.

dwOsMajorVersion [in]

O número de versão principal do sistema operacional. Esse membro pode ser um dos valores a seguir.

Valor Significado
5
 Se dwOsMinorVersion for 1, o sistema operacional será o Windows XP.
Se dwOsMinorVersion for 2, o sistema operacional será Windows Server 2003 R2, Windows Server 2003 ou Windows XP Professional x64 Edition.
6
 Se dwOsMinorVersion for 0, o sistema operacional será o Windows Server 2008 ou o Windows Vista.
Se dwOsMinorVersion for 1, o sistema operacional será o Windows Server 2008 R2 ou o Windows 7.

 

dwOsMinorVersion [in]

O número de versão secundária do sistema operacional. Esse membro pode ser um dos valores a seguir.

Valor Significado
0
 Se dwOsMajorVersion for 6, o sistema operacional será Windows Server 2008 ou Windows Vista.
1
 Se dwOsMajorVersion for 5, o sistema operacional será o Windows XP.
Se dwOsMajorVersion for 6, o sistema operacional será o Windows Server 2008 R2 ou o Windows 7.
2
 Se dwOsMajorVersion for 5, o sistema operacional será Windows Server 2003 R2, Windows Server 2003 ou Windows XP Professional x64 Edition.
Se dwOsMajorVersion for 6, o parâmetro dwOsMinorVersion deverá ser 0 ou 1.

 

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor de retorno será o código de erro diferente de zero definido em Winerror.h. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma descrição genérica do erro. Os códigos de erro possíveis incluem o seguinte:

  • Se o chamador não tiver os direitos de acesso necessários para gravar o arquivo, a função retornará ERROR_ACCESS_DENIED.
  • Se o arquivo especificado já existir, a função retornará ERROR_ALREADY_EXISTS.

Comentários

A função ORSaveHive deve ser usada para salvar as alterações feitas em um hive de registro offline. As alterações não são preservadas até que ORSaveHive seja chamado para salvar o hive em um arquivo.

Os parâmetros dwOsMajorVersion e dwOsMinorVersion juntos especificam o formato de destino do arquivo hive do Registro. A tabela a seguir resume os números de versão mais recentes do sistema operacional.

Sistema operacional Número de versão
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 a função GetVersionEx para recuperar informações sobre o sistema operacional atual.

A função ORSaveHive bloqueia o hive do Registro enquanto ele está gravando o hive no arquivo e fecha o arquivo e libera o bloqueio. O hive do registro permanece na memória até ser fechado chamando a função ORCloseHive . É possível fazer mais alterações no hive do Registro enquanto ele está aberto; no entanto, para preservar essas alterações, o hive deve ser salvo em um novo arquivo, pois a função ORSaveHive não substituirá um arquivo existente.

A função ORSaveHive pode ser usada para salvar parte do hive do registro offline. A chave especificada no parâmetro Handle torna-se a chave raiz de um hive que consiste na chave especificada e em todas as suas subchaves.

Requisitos

Requisito Valor
Redistribuível
 Biblioteca do Registro Offline do Windows versão 1.0 ou posterior
Cabeçalho
Offreg.h
DLL
Offreg.dll

Confira também

Getversionex

ORCloseHive

OROpenHive