Função RegReplaceKeyA (winreg.h)
Substitui o arquivo que faz backup de uma chave do Registro e todas as subchaves por outro arquivo, de modo que, quando o sistema for iniciado, a chave e as subchaves terão os valores armazenados no novo arquivo.
Os aplicativos que backupm ou restauram o estado do sistema, incluindo arquivos do sistema e hives de registro, devem usar o serviço de cópia de sombra de volume em vez das funções do Registro.
Sintaxe
LSTATUS RegReplaceKeyA(
[in] HKEY hKey,
[in, optional] LPCSTR lpSubKey,
[in] LPCSTR lpNewFile,
[in] LPCSTR lpOldFile
);
Parâmetros
[in] hKey
Um identificador para uma chave aberta do Registro. Esse identificador é retornado pela função RegCreateKeyEx
HKEY_CLASSES_ROOTHKEY_CURRENT_CONFIGHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERS
[in, optional] lpSubKey
O nome da chave do Registro cujas subchaves e valores devem ser substituídos. Se a chave existir, ela deverá ser uma subchave da chave identificada pelo parâmetro hKey. Se a subchave não existir, ela será criada. Esse parâmetro pode ser NULL.
Se a subchave especificada não for a raiz de um hive, RegReplaceKey percorrerá a estrutura da árvore do hive até encontrar uma raiz de hive, então ela substituirá o conteúdo desse hive pelo conteúdo do arquivo de dados especificado por lpNewFile.
Para obter mais informações, consulte limites de tamanho do elemento do Registro.
[in] lpNewFile
O nome do arquivo com as informações do Registro. Esse arquivo normalmente é criado usando a função RegSaveKey.
[in] lpOldFile
O nome do arquivo que recebe uma cópia de backup das informações do Registro que estão sendo substituídas.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.
Se a função falhar, o valor retornado será um código de erro diferente de zero definido em Winerror.h. Você pode usar a função
Observações
Há dois formatos de arquivo hive de registro diferentes. Os hives do Registro criados em sistemas operacionais atuais normalmente não podem ser carregados pelos anteriores.
O arquivo especificado pelo parâmetro lpNewFile permanece aberto até que o sistema seja reiniciado.
Se hKey for um identificador retornado por RegConnectRegistry, os caminhos especificados em lpNewFile e lpOldFile serão relativos ao computador remoto.
O processo de chamada deve ter os privilégios SE_RESTORE_NAME e SE_BACKUP_NAME no computador no qual o registro reside. Para obter mais informações, consulte Em execução com privilégios especiais.
Nota
O cabeçalho winreg.h define RegReplaceKey como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winreg.h (inclua Windows.h) |
| biblioteca | Advapi32.lib |
| de DLL |
Advapi32.dll |
Consulte também
RegConnectRegistry
RegDeleteKey