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

Voir aussi

RegCloseKey

RegDeleteKey

Fonctions de Registre

Vue d’ensemble du Registre