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é.
Versions 27 et supérieures
Nouveauté 27
// 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
Versions 27 et supérieuresMode d'accès à la base de registre :
| |
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.
|
| registreMode32 | Mode d'accès forcé pour accéder à la base de registre comme un programme 32 bits. |
| registreMode64 | Mode d'accès forcé pour accéder à la base de registre comme un programme 64 bits. |
Nouveauté 27Mode d'accès à la base de registre :
| |
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.
|
| registreMode32 | Mode d'accès forcé pour accéder à la base de registre comme un programme 32 bits. |
| registreMode64 | Mode d'accès forcé pour accéder à la base de registre comme un programme 64 bits. |
Mode d'accès à la base de registre :
| |
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.
|
| registreMode32 | Mode d'accès forcé pour accéder à la base de registre comme un programme 32 bits. |
| registreMode64 | Mode d'accès forcé pour accéder à 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
Versions 27 et supérieuresMode d'accès à la base de registre :
| |
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.
|
| registreMode32 | Mode d'accès forcé pour accéder à la base de registre comme un programme 32 bits. |
| registreMode64 | Mode d'accès forcé pour accéder à la base de registre comme un programme 64 bits. |
Nouveauté 27Mode d'accès à la base de registre :
| |
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.
|
| registreMode32 | Mode d'accès forcé pour accéder à la base de registre comme un programme 32 bits. |
| registreMode64 | Mode d'accès forcé pour accéder à la base de registre comme un programme 64 bits. |
Mode d'accès à la base de registre :
| |
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.
|
| registreMode32 | Mode d'accès forcé pour accéder à la base de registre comme un programme 32 bits. |
| registreMode64 | Mode d'accès forcé pour accéder à 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.
- 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 : wd270std.dll