DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Base de registre
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
RegistreRenomme (Fonction)
En anglais : RegistryRename
Renomme une clé et/ou une valeur de la base de registre.
Remarque : Renommer une clé consiste à :
  • Copier la clé.
  • Renommer la clé copiée.
  • Supprimer l'ancienne clé.
Exemple
// Renomme la clé "MonAppli" en "MonApplication"
RegistreRenomme("HKEY_LOCAL_MACHINE\SOFTWARE\MonAppli", "HKEY_LOCAL_MACHINE\SOFTWARE\MonApplication")

// Renomme la valeur "Auto" en "Automatique"
RegistreRenomme("HKEY_LOCAL_MACHINE\SOFTWARE\MonAppli", "Auto", "Automatique")
Syntaxe

Renommage d'une clé de la base de registre Masquer les détails

<Résultat> = RegistreRenomme([<Mode d'accès>, ] <Nom de la clé à renommer> , <Nouveau nom de la clé>)
<Résultat> : Booléen
  • Vrai si le renommage a été effectué,
  • Faux dans le cas contraire.
<Mode d'accès> : Constante de type Entier
Mode d'accès à la base de registre :
registreMode32Mode d'accès forcé pour accéder à la base de registre comme un programme 32 bits.
registreMode64Mode d'accès forcé pour accéder à la base de registre comme un programme 64 bits.
registreModeAuto
(Valeur par défaut)
Mode d'accès à la base de registre automatique :
  • une application 32 bits exécutée sur un système 32 bits manipule la base de registre comme un programme 32 bits.
  • une application 32 bits exécutée sur un système 64 bits manipule la base de registre à partir de la branche suivante :
    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node
  • une application 64 bits exécutée sur un système 64 bits manipule la base de registre comme un programme 64 bits.
<Nom de la clé à renommer> : Chaîne de caractères
Chemin complet de la clé à renommer. Si cette clé n'existe pas, <Résultat> renverra Faux.
<Nouveau nom de la clé> : Chaîne de caractères
Nouveau chemin et nom de la clé. Si cette clé existe déjà, <Résultat> renverra Faux.

Renommage d'une clé de la base de registre et de sa valeur Masquer les détails

<Résultat> = RegistreRenomme([<Mode d'accès>, ] <Nom de la clé à renommer> , <Nom de la valeur à renommer> [, <Nouveau nom de la clé>] , <Nouveau nom de la valeur>)
<Résultat> : Booléen
  • Vrai si le renommage a été effectué,
  • Faux dans le cas contraire.
<Mode d'accès> : Constante de type Entier
Mode d'accès à la base de registre :
registreMode32Mode d'accès forcé pour accéder à la base de registre comme un programme 32 bits.
registreMode64Mode d'accès forcé pour accéder à la base de registre comme un programme 64 bits.
registreModeAuto
(Valeur par défaut)
Mode d'accès à la base de registre automatique :
  • une application 32 bits exécutée sur un système 32 bits manipule la base de registre comme un programme 32 bits.
  • une application 32 bits exécutée sur un système 64 bits manipule la base de registre à partir de la branche suivante :
    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node
  • une application 64 bits exécutée sur un système 64 bits manipule la base de registre comme un programme 64 bits.
<Nom de la clé à renommer> : Chaîne de caractères
Chemin complet de la clé à renommer. Si cette clé n'existe pas, <Résultat> renverra Faux.
<Nom de la valeur à renommer> : Chaîne de caractères
Nom de la valeur à renommer dans la base de registre pour la clé spécifiée. Si cette valeur n'existe pas, <Résultat> renverra Faux.
<Nouveau nom de la clé> : Chaîne de caractères optionnelle
Nouveau chemin et nom de la clé. Si ce paramètre correspond à une chaîne vide ("") ou n'est pas précisé, le nom de la clé n'est pas modifié. Si cette clé existe déjà, <Résultat> renverra Faux.
<Nouveau nom de la valeur> : Chaîne de caractères
Nouveau nom de la valeur dans la base de registre pour la clé spécifiée.
Remarques
  • La fonction RegistreRenomme effectue une copie récursive puis une suppression récursive.
  • Sous Windows Vista (et supérieurs), les opérations liées au renommage sont effectuées dans une transaction. En cas d'échec d'une opération, toutes les opérations précédentes sont annulées.
  • Le propriétaire de la clé n'est pas conservé pendant le renommage (déplacement).
Classification Métier / UI : Code métier
Composante : wd290std.dll
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/07/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale