Fonction RegCloseKey (winreg.h)
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 |