PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
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(<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.
<Nom de la clé à renommer> : Chaîne de caractères (avec guillemets)
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 (avec guillemets)
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(<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.
<Nom de la clé à renommer> : Chaîne de caractères (avec guillemets)
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 (avec guillemets)
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 (avec guillemets)
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 (avec guillemets)
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.
  • Sur les versions de Windows antérieures à Windows Vista, les opérations liées au renommage ne sont pas effectuées en transaction. En cas d’échec d’une opération (suppression d’une clé par exemple), les opérations précédentes (copie de la clé par exemple) ne sont pas annulées.
Classification Métier / UI : Code métier
Composante : wd250std.dll
Version minimum requise
  • Version 16
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire