RegFlushKey, fonction (winreg.h)
Écrit tous les attributs de la clé de Registre ouverte spécifiée dans le Registre.
Syntaxe
LSTATUS RegFlushKey(
[in] HKEY hKey
);
Paramètres
[in] hKey
Handle d’une clé de Registre ouverte. La clé doit avoir été ouverte avec le droit d’accès KEY_QUERY_VALUE. Pour plus d’informations, consultez Sécurité de la clé de Registre et droits d’accès.
Ce handle est retourné par la fonction RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx ou RegOpenKeyTransacted . Il peut également s’agir de 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
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour est un code d’erreur différent de zéro défini dans Winerror.h. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur.
Remarques
L’appel de RegFlushKey est une opération coûteuse qui affecte considérablement les performances à l’échelle 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 du Registre qui est vidée jusqu’à la fin de l’opération de vidage. RegFlushKey ne doit être appelé explicitement que 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 d’autres processus sans qu’il soit nécessaire de les vider sur le disque.
Le registre a également un mécanisme de « vidage différé » qui vide les modifications du registre sur le disque à intervalles réguliers. En plus de cette opération de vidage standard, les modifications du Registre sont également vidées sur le disque à l’arrêt du système. Autoriser le « vidage différé » pour vider les modifications de Registre est le moyen le plus efficace de gérer les écritures du Registre dans le magasin du Registre sur disque.
La fonction RegFlushKey retourne uniquement lorsque toutes les données de la ruche qui contient la clé spécifiée ont été écrites dans le magasin du Registre sur disque.
La fonction RegFlushKey écrit les données des autres clés de la ruche qui ont été modifiées depuis le dernier vidage différé ou le dernier démarrage du système.
Une fois regFlushKey retourné, utilisez RegCloseKey pour fermer le handle à la clé de Registre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winreg.h (inclure Windows.h) |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |