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

Voir aussi

RegConnectRegistry

RegCreateKeyEx

RegDeleteKey

RegFlushKey

RegOpenKeyEx

Fonctions du Registre

Vue d’ensemble du Registre