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

Voir aussi

RegCloseKey

RegDeleteKey

Fonctions de Registre

Vue d’ensemble du Registre