Função RegUnLoadKeyA (winreg.h)

Descarrega a chave do Registro especificada e suas subchaves do registro.

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 RegUnLoadKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey
);

Parâmetros

[in] hKey

Um identificador para a chave do Registro a ser descarregada. Esse parâmetro pode ser um identificador retornado por uma chamada para função regConnectRegistry ou um dos seguintes identificadores predefinidos:

HKEY_LOCAL_MACHINEHKEY_USERS

[in, optional] lpSubKey

O nome da subchave a ser descarregada. A chave referenciada pelo parâmetro lpSubKey deve ter sido criada usando a função RegLoadKey.

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.

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 FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para obter uma descrição genérica do erro.

Observações

Essa função remove um hive do registro, mas não modifica o arquivo que contém as informações do Registro. Um hive é um corpo discreto de chaves, subchaves e valores que tem raiz na parte superior da hierarquia do Registro.

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.

Requisitos

Consulte também

RegConnectRegistry

RegDeleteKey

RegLoadKey

RegRestoreKey

Funções do Registro

Visão geral do Registro