Função RegCloseKey (winreg.h)

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

Confira também

RegConnectRegistry

RegCreateKeyEx

RegDeleteKey

Regflushkey

RegOpenKeyEx

Funções do Registro

Visão geral do Registro