- Types des données écrites
- Application 32 bits fonctionnant sur un système 64 bits
- Manipulation de la base de registre sous Windows Vista
- Limites de la fonction RegistreEcrit
- Équivalence
RegistreEcrit (Fonction) En anglais : RegistrySetValue Écrit une valeur dans un registre de la base de registre de Windows. Attention : La clé doit exister pour pouvoir y écrire une valeur. Pour créer une clé, utilisez la fonction RegistreCréeClé.
// Écrire la valeur "English" dans la valeur "Langage"
// dans la clé "HKEY_LOCAL_MACHINE\SOFTWARE\MonAppli"
ResEcriture = RegistreEcrit("HKEY_LOCAL_MACHINE\SOFTWARE\MonAppli", ...
"Langage", "English")
Syntaxe
Écrire une valeur identifiée par son nom dans une base de registre Masquer les détails
<Résultat> = RegistreEcrit(<Chemin de la clé> , <Nom de la valeur> , <Valeur> [, <Longueur>])
<Résultat> : Booléen - Vrai si la valeur a été écrite,
- Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Chemin de la clé> : Chaîne de caractères (avec guillemets) Chemin complet de la clé à manipuler. Cette clé doit exister pour pouvoir lui donner une valeur. <Nom de la valeur> : Chaîne de caractères (avec guillemets) Nom de la valeur à écrire. Si la valeur n'existe pas, elle sera créée. <Valeur> : Chaîne de caractères, entier, réel ou pointeur Valeur à écrire. Cette valeur ne doit pas correspondre directement à un champ de saisie numérique par exemple. Il est nécessaire d'utiliser une variable typée (déclarée en tant que réel, chaîne de caractères, ...). <Longueur> : Entier optionnel Longueur de la valeur à écrire lorsque le paramètre <Valeur> correspond à un pointeur.
Écrire une valeur typée identifiée par son nom dans une base de registre Masquer les détails
<Résultat> = RegistreEcrit(<Chemin de la clé> , <Nom de la valeur> , <Valeur> , <Type de la valeur>)
<Résultat> : Booléen - Vrai si la valeur a été écrite,
- Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Chemin de la clé> : Chaîne de caractères (avec guillemets) Chemin complet de la clé à manipuler. Cette clé doit exister pour pouvoir lui donner une valeur. <Nom de la valeur> : Chaîne de caractères (avec guillemets) Nom de la valeur à écrire. Si la valeur n'existe pas, elle sera créée. <Valeur> : Chaîne de caractères, entier, réel ou pointeur Valeur à écrire. Si le paramètre <Type de la valeur> est utilisé, la valeur est automatiquement convertie dans le bon type <Type de la valeur> : Constante de type chaîne de caractères Type de la valeur à écrire : | | | RegistreTypeBinaire | Clé de type Binaire. Dans ce cas la taille en octets de la donnée écrite sera celle de la variable donnée en <Valeur>. | | RegistreTypeChaîne | Clé de type Chaîne. | | RegistreTypeChaîneEnv | Clé de type Chaîne contenant des variables d'environnement. | | RegistreTypeEntier | Clé de type Entier sur 4 octets. | | RegistreTypeEntier_8 | Clé de type Entier sur 8 octets. | | RegistreTypeEntierBigEndian | Clé de type Entier au format big-endian. | | RegistreTypeMultiChaîne | Clé de type Multichaîne. Dans ce cas, <Valeur> doit correspondre à une série de chaînes séparées par le caractère "Caract(0)". |
Écrire une valeur identifiée par son indice dans une base de registre Masquer les détails
<Résultat> = RegistreEcrit(<Chemin de la clé> , <Indice de la valeur> , <Valeur> [, <Longueur>])
<Résultat> : Booléen - Vrai si la valeur a été écrite,
- Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Chemin de la clé> : Chaîne de caractères (avec guillemets) Chemin complet de la clé à manipuler. Cette clé doit exister pour pouvoir lui donner une valeur. <Indice de la valeur> : Entier Indice de la valeur à écrire. <Valeur> : Chaîne de caractères, entier, réel ou pointeur Valeur à écrire. <Longueur> : Entier optionnel Longueur de la valeur à écrire lorsque le paramètre <Valeur> correspond à un pointeur.
Écrire une valeur typée identifiée par son indice dans une base de registre Masquer les détails
<Résultat> = RegistreEcrit(<Chemin de la clé> , <Indice de la valeur> , <Valeur> , <Type de la valeur>)
<Résultat> : Booléen - Vrai si la valeur a été écrite,
- Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Chemin de la clé> : Chaîne de caractères (avec guillemets) Chemin complet de la clé à manipuler. Cette clé doit exister pour pouvoir lui donner une valeur. <Indice de la valeur> : Entier Indice de la valeur à écrire. <Valeur> : Chaîne de caractères, entier, réel ou pointeur Valeur à écrire. <Type de la valeur> : Constante de type chaîne de caractères Type de la valeur à écrire : | | | RegistreTypeBinaire | Clé de type Binaire. Dans ce cas la taille en octets de la donnée écrite sera celle de la variable donnée en <Vvaleur>. | | RegistreTypeChaîne | Clé de type Chaîne. | | RegistreTypeChaîneEnv | Clé de type Chaîne contenant des variables d'environnement. | | RegistreTypeEntier | Clé de type Entier sur 4 octets. | | RegistreTypeEntier_8 | Clé de type Entier sur 8 octets. | | RegistreTypeEntierBigEndian | Clé de type Entier au format big-endian | | RegistreTypeMultiChaîne | Clé de type Multichaîne. Dans ce cas, <Valeur> doit correspondre à une série de chaînes séparées par le caractère "Caract(0)". |
Remarques Limites de la fonction RegistreEcrit La fonction RegistreEcrit ne fonctionne pas sur les entrées du type "(par défaut)". En effet, ces entrées sont spécifiques. Pour atteindre ces entrées, remplacez le nom de la clé par une chaîne vide. Exemple : Ne pas faire :
RegistreEcrit("HKEY_CLASSES_ROOT\.jar", "(par défaut)", "myfile")
Faire :
RegistreEcrit("HKEY_CLASSES_ROOT\.jar", "", "myfile")
Classification Métier / UI : Code métier Composante : wd260std.dll
Documentation également disponible pour…
|
|
|