Share via


Action RemoveEnvironmentStrings

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 informe le système des modifications à la fin de l’installation. 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 seulement lors de l’installation ou de la réinstallation d’un composant, et exécute l’action SupprimerEnvironmentStrings seulement lors de la suppression d’un composant.

Les valeurs sont écrites ou supprimées en fonction de la sélection des actions et des modificateurs principaux. Ceux-ci sont décrits 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. Comme l’action WriteEnvironmentStrings et l’action RemoveEnvironmentStrings ne sont jamais appliquées ensemble lors de l’installation ou de la suppression d’un composant, leur séquence relative n’est pas restreinte.

Messages ActionData

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

 

Valeur en bits Description des actions principales
0x1 Prêts ? Définit la valeur de la variable d’environnement dans tous les cas.
Si ce bit est combiné à un bit de modificateur Ajout ou Préfixe, l’action ajoute la valeur à n’importe quelle valeur existante dans la variable.
0x2 Prêts ? Définit la valeur si la variable est absente.
Si ce bit est combiné à un bit de modificateur Ajout ou Préfixe, l’action ajoute la valeur à n’importe quelle valeur existante dans la variable.
0x4 Supprimer. Supprime la valeur de la variable.
Si ce bit est combiné avec un bit de modificateur Ajout ou Préfixe, la valeur est supprimée de la chaîne existante si la valeur existe.

 

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