RegReplaceKey

9/8/2008

Essa função substitui o arquivo fazendo uma chave Registro e todas as suas subchaves com outro arquivo, de modo que quando o sistema seja iniciado, próximo a chave e subchaves têm os valores armazenados no novo arquivo.

Syntax

LONG RegReplaceKey( 
  HKEY hKey,
  LPCTSTR lpSubKey,
  LPCTSTR lpNewFile,
  LPCTSTR lpOldFile
);

Parameters

• hKey
  [no] Deve ser definido como HKEY_LOCAL_MACHINE.

• lpSubKey
  [no] Deve ser definido como NULL.

• lpNewFile
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que contém o nome do arquivo com informações Registro. Este arquivo é geralmente criado usando a função RegSaveKey. Este valor pode ser conjunto para conjunto para NULL.

• lpOldFile
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que contém o nome de um arquivo que recebe um cópia de backup de informações de Registro que está sendo substituídas. Este valor pode ser definido como NULL.

Return Value

Se GetLastError retorna o valor da função ou ERROR_NOT_SUPPORTED, essa função não é com suporte em Registro Store-Based o objeto.

Se GetLastError Retorna ERROR_ACCESS_DENIED, somente os aplicativos com privilégios pode chamar esta função.

Remarks

Esta função pode ser usada somente para restaurar um cópia de backup de ramificação Registro a sistema, que contém todos os dados em HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, e HKEY_USERS. Para restaurar uma ramificação usuário salvos, mover o arquivo para perfil Diretório do usuário enquanto o usuário não fez logon. Chamadas subseqüentes para a função SetCurrentUser usam a ramificação restaurada.

A ramificação sistema for desmontada e não é remontada até que o sistema seja reiniciado. Isso significa que o Registro sistema se torne inutilizado. Ambos os arquivos permanecem fechados após este chamar. O atual ramificação Registro é movida para lpOldFile.

Se lpNewFile não-NULL, esse arquivo é renomeado para ser a ramificação Registro e está montado quando o sistema for reiniciado.

Se lpNewFile é definido como NULL, uma ramificação usar como padrão é carregada do ROM quando o sistema for reiniciado.

Essa função é com suporte Somente somente para um Registro Hive-Based. Para salvar e restaurar dados no Registro Store-Based objeto, consulte RegCopyFile e RegRestoreFile.

Requirements

Header	pwinreg.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Registry Functions
RegSaveKey
RegCopyFile
RegRestoreFile
SetCurrentUser

Concepts

Data Persistence with the Hive-Based Registry