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 |