Écrit tous les attributs de la clé de registre ouverte spécifiée dans le registre
#include <WinAPIReg.au3>
_WinAPI_RegFlushKey ( $hKey )
| $hKey |
Handle de la clé de registre ouverte. La clé doit avoir été ouverte avec le droit d'accès $KEY_QUERY_VALUE. Ce handle est retourné par la fonction _WinAPI_RegCreateKey() ou _WinAPI_RegOpenKey(). Il peut également être l'une des clés prédéfinies suivantes: $HKEY_CLASSES_ROOT $HKEY_CURRENT_CONFIG $HKEY_CURRENT_USER $HKEY_LOCAL_MACHINE $HKEY_PERFORMANCE_DATA $HKEY_USERS |
| Succès: | Retourne 1. |
| Échec: | Retourne 0 et définit @error <> 0, @extended peut contenir le code d'erreur du système. |
L'appel à _WinAPI_RegFlushKey() est une opération coûteuse qui affecte considérablement les performances du système car elle consomme de la bande passante disque et bloque les modifications apportées à toutes les clés par tous les processus de la ruche de registre qui est vidée jusqu'à la fin de l'opération de vidage. _WinAPI_RegFlushKey() doit être appelée explicitement lorsqu'une application doit garantir que les modifications du registre sont conservées sur le disque immédiatement après la modification. Toutes les modifications apportées aux clés sont visibles par les autres processus sans qu'il soit nécessaire de les vider sur le disque.
Alternativement, le registre dispose d'un mécanisme de 'vidage paresseux' qui vide les modifications du registre sur le disque à intervalles réguliers. En plus de cette opération de vidage normale, les modifications du registre sont également vidées sur le disque lors de l'arrêt du système. Autoriser le flush paresseux à vider les modifications du registre est le moyen le plus efficace de gérer les écritures de registre dans le registre sur le disque.
La fonction _WinAPI_RegFlushKey() retourne uniquement lorsque toutes les données de la ruche qui contient la clé spécifiée ont été écrites dans le magasin de registre sur le disque.
La fonction _WinAPI_RegFlushKey() écrit les données pour les autres clés de la ruche qui ont été modifiées depuis le dernier vidage paresseux ou le démarrage du système.
Après le retour de _WinAPI_RegFlushKey(), utilisez _WinAPI_RegCloseKey() pour fermer le handle de la clé de registre.
_WinAPI_RegCloseKey, _WinAPI_RegCreateKey, _WinAPI_RegOpenKey
Consultez RegFlushKey dans la librairie MSDN.