Compartir a través de


Función RegCloseKey (winreg.h)

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

Consulte también

RegConnectRegistry

RegCreateKeyEx

RegDeleteKey

RegFlushKey

RegOpenKeyEx

Funciones del Registro

Introducción al Registro