Fonction RegCloseKey (winreg.h)

Article
08/27/2023

Ferme un handle à la clé de Registre spécifiée.

Syntaxe

LSTATUS RegCloseKey(
  [in] HKEY hKey
);

Paramètres

[in] hKey

Handle de la clé ouverte à fermer. Le handle doit avoir été ouvert par la fonction RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, RegOpenKeyTransacted ou RegConnectRegistry .

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

Le handle d’une clé spécifiée ne doit pas être utilisé après sa fermeture, car il ne sera plus valide. Les poignées de clés ne doivent pas être laissées ouvertes plus longtemps que nécessaire.

La fonction RegCloseKey n’écrit pas nécessairement les informations dans le Registre avant le retour ; le vidage du cache sur le disque dur peut prendre jusqu’à plusieurs secondes. Si une application doit écrire explicitement des informations de Registre sur le disque dur, elle peut utiliser la fonction RegFlushKey . RegFlushKey, toutefois, utilise de nombreuses ressources système et ne doit être appelé que si nécessaire.

Exemples

Pour obtenir un exemple, consultez Suppression d’une clé avec des sous-clés.

Configuration requise


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