Função RegLoadKeyA (winreg.h)
Cria uma subchave em HKEY_USERS ou HKEY_LOCAL_MACHINE e carrega os dados do hive do Registro especificado nessa subchave.
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 RegLoadKeyA(
[in] HKEY hKey,
[in, optional] LPCSTR lpSubKey,
[in] LPCSTR lpFile
);
Parâmetros
[in] hKey
Um identificador para a chave em que a subchave será criada. Esse pode ser um identificador retornado por uma chamada para RegConnectRegistry ou um dos seguintes identificadores predefinidos:
HKEY_LOCAL_MACHINEHKEY_USERS Essa função sempre carrega informações na parte superior da hierarquia do Registro. Os valores de identificador de HKEY_CLASSES_ROOT e HKEY_CURRENT_USER não podem ser especificados para esse parâmetro, pois representam subconjuntos dos valores de identificador HKEY_LOCAL_MACHINE e HKEY_USERS, respectivamente.
[in, optional] lpSubKey
O nome da chave a ser criada em hKey. Essa subchave é onde as informações de registro do arquivo serão carregadas.
Os nomes de chave não diferenciam maiúsculas de minúsculas.
Para obter mais informações, consulte limites de tamanho do elemento do Registro.
[in] lpFile
O nome do arquivo que contém os dados do Registro. Esse arquivo deve ser um arquivo local que foi criado com a função RegSaveKey. Se esse arquivo não existir, um arquivo será criado com o nome especificado.
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 do Registro. Os hives do Registro criados em sistemas operacionais atuais normalmente não podem ser carregados pelos anteriores.
Se hKey for um identificador retornado por RegConnectRegistry, o caminho especificado em lpFile será relativo 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. Para carregar um hive sem exigir esses privilégios especiais, use a função RegLoadAppKey.
Nota
O cabeçalho winreg.h define RegLoadKey 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