Función RegFlushKey (winreg.h)
Escribe todos los atributos de la clave del Registro abierta y especificada en el Registro.
Sintaxis
LSTATUS RegFlushKey(
[in] HKEY hKey
);
Parámetros
[in] hKey
Identificador de una clave del Registro abierta. La clave debe haberse abierto con el derecho de acceso KEY_QUERY_VALUE. Para obtener más información, consulte Derechos de acceso y seguridad de clave del Registro.
Este identificador lo devuelve la función RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx o RegOpenKeyTransacted . También puede ser una de las siguientes claves predefinidas:
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_PERFORMANCE_DATA
- HKEY_USERS
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
Llamar a RegFlushKey es una operación costosa que afecta significativamente al rendimiento de todo el sistema, ya que consume ancho de banda de disco y bloquea las modificaciones en todas las claves por todos los procesos del subárbol del Registro que se vacían hasta que se completa la operación de vaciado. RegFlushKey solo se debe llamar explícitamente cuando una aplicación debe garantizar que los cambios del Registro se conserven en el disco inmediatamente después de la modificación. Todas las modificaciones realizadas en las claves son visibles para otros procesos sin necesidad de vaciarlas en el disco.
Como alternativa, el registro tiene un mecanismo de vaciado diferido que vacía las modificaciones del registro en el disco a intervalos regulares de tiempo. Además de esta operación de vaciado normal, los cambios del Registro también se vacían en el disco durante el apagado del sistema. Permitir el vaciado diferido para vaciar los cambios del Registro es la manera más eficaz de administrar las escrituras del Registro en el almacén del Registro en el disco.
La función RegFlushKey solo devuelve cuando todos los datos del subárbol que contiene la clave especificada se han escrito en el almacén del Registro en el disco.
La función RegFlushKey escribe los datos de otras claves del subárbol que se han modificado desde el último vaciado diferido o inicio del sistema.
Después de que RegFlushKey vuelva, use RegCloseKey para cerrar el identificador de la clave del Registro.
Requisitos
| Requisito | Value |
|---|---|
| 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 (incluye Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |