Função RegCloseKey (winreg.h)

Artigo
08/27/2023

Fecha um identificador para a chave do Registro especificada.

Sintaxe

LSTATUS RegCloseKey(
  [in] HKEY hKey
);

Parâmetros

[in] hKey

Um identificador para a chave aberta a ser fechada. O identificador deve ter sido aberto pela função RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, RegOpenKeyTransacted ou RegConnectRegistry .

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.

Comentários

O identificador de uma chave especificada não deve ser usado depois de fechado, pois não será mais válido. Os identificadores de chave não devem ser deixados abertos por mais tempo do que o necessário.

A função RegCloseKey não necessariamente grava informações no registro antes de retornar; pode levar até vários segundos para que o cache seja liberado para o disco rígido. Se um aplicativo precisar gravar explicitamente informações do Registro no disco rígido, ele poderá usar a função RegFlushKey . RegFlushKey, no entanto, usa muitos recursos do sistema e deve ser chamado somente quando necessário.

Exemplos

Para obter um exemplo, consulte Excluindo uma chave com subchaves.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winreg.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll