Función RegCloseKey (winreg.h)

Artículo
08/27/2023

Cierra un identificador de la clave del Registro especificada.

Sintaxis

LSTATUS RegCloseKey(
  [in] HKEY hKey
);

Parámetros

[in] hKey

Identificador de la tecla abierta que se va a cerrar. El identificador debe haber sido abierto por la función RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, RegOpenKeyTransacted o RegConnectRegistry .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si la función no se ejecuta correctamente, el valor devuelto es un código de error distinto de cero definido en Winerror.h. Puede usar la función FormatMessage con la marca FORMAT_MESSAGE_FROM_SYSTEM para obtener una descripción genérica del error.

Comentarios

El identificador de una clave especificada no se debe usar después de cerrarlo, ya que ya no será válido. Los identificadores de clave no deben dejarse abiertos más de lo necesario.

La función RegCloseKey no escribe necesariamente información en el registro antes de devolverla; la memoria caché puede tardar tantos segundos en vaciarse en el disco duro. Si una aplicación debe escribir explícitamente información del Registro en el disco duro, puede usar la función RegFlushKey . RegFlushKey, sin embargo, usa muchos recursos del sistema y solo se debe llamar cuando sea necesario.

Ejemplos

Para obtener un ejemplo, consulte Eliminación de una clave con subclaves.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winreg.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll