Partager via

RemoveEnvironmentStrings, action

  • Article

L’action RemoveEnvironmentStrings modifie les valeurs des variables d’environnement.

Notez que les variables d’environnement ne changent pas pour l’installation en cours lorsque l’action WriteEnvironmentStrings ou RemoveEnvironmentStrings est exécutée. Sur Windows 2000, ces informations sont stockées dans le Registre et un message est envoyé pour notifier le système de modifications une fois l’installation terminée. Un nouveau processus, ou un autre processus qui recherche ces messages, utilisera les nouvelles variables d’environnement.

Le programme d’installation exécute l’action WriteEnvironmentStrings uniquement pendant l’installation ou la réinstallation d’un composant, et exécute l’action RemoveEnvironmentStrings uniquement pendant la suppression d’un composant.

Les valeurs sont écrites ou supprimées en fonction de la sélection des actions et modificateurs principaux. Ces informations sont décrites dans la section Messages ActionData suivante. Notez que, selon l’action spécifiée, WriteEnvironmentStrings peut supprimer des variables, et RemoveEnvironmentStrings peut les ajouter en fonction de la création de la table Environment.

Restrictions de séquence

L’action InstallValidate doit être exécutée avant l’action RemoveEnvironmentStrings. Étant donné que l’action WriteEnvironmentStrings et l’action RemoveEnvironmentStrings ne sont jamais appliquées lors de l’installation ou de la suppression d’un composant, leur séquence relative n’est pas limitée.

ActionData Messages

Champ Description des données d’action
[1] Nom de la variable d’environnement à modifier.
[2] Valeur de la variable d’environnement.
[3] Il s’agit d’un champ d’indicateurs de bits qui spécifient l’action à effectuer. Incluez un seul bit pour une action principale. Plusieurs bits de modificateur peuvent être inclus dans ce champ. Consultez les descriptions d’indicateurs de bits suivantes.

 

Valeur du bit Description des actions principales
0x1 Poser. Définit la valeur de la variable d’environnement dans tous les cas.
Si ce bit est combiné à un bit de modificateur d’ajout ou de préfixe, l’action ajoute la valeur à n’importe quelle valeur existante dans la variable.
0x2 Poser. Définit la valeur si la variable est absente.
Si ce bit est combiné à un bit de modificateur d’ajout ou de préfixe, l’action ajoute la valeur à n’importe quelle valeur existante dans la variable.
0x4 Enlever. Supprime la valeur de la variable.
Si ce bit est combiné à un bit de modificateur d’ajout ou de préfixe, la valeur est supprimée de la chaîne existante, si la valeur existe.

 

Valeur du bit Description du modificateur
0x20000000 Si ce bit est défini, les actions sont appliquées aux variables d’environnement de l’ordinateur.
Si ce bit n’est pas défini, les actions sont appliquées aux variables d’environnement de l’utilisateur.
0x40000000 Ajouter. Ce bit est facultatif. Ne définissez pas les modificateurs Append et Prefix.
0x80000000 Préfixe. Ce bit est facultatif. Ne définissez pas les modificateurs Append et Prefix.