Função ORSaveHive
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 |
|
| DLL |
|
Confira também