WriteEnvironmentStrings, action

  • Article

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

Les variables d’environnement ne changent pas pour l’installation en cours quand l’action WriteEnvironmentStrings ou l’action RemoveEnvironmentStrings est exécutée. Sur Windows 2000, Windows Server 2003, Windows XP et Windows Vista, ces informations sont stockées dans le Registre et un message WM_SETTINGCHANGE est envoyé pour informer le système des modifications à la fin de l’installation. Un autre processus peut recevoir une notification des modifications en gérant ces messages. Aucun message n’est envoyé si un redémarrage du système est en attente. Un package peut utiliser la propriété MsiSystemRebootPending pour vérifier si un redémarrage du système est en attente.

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 RemoveEnvironmentStrings 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é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 des séquences

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 d’une installation ou d’une 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 du bit 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 du bit 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.