Operazione WriteEnvironmentStrings
L'azione WriteEnvironmentStrings modifica i valori delle variabili di ambiente.
Le variabili di ambiente non cambiano per l'installazione in corso quando viene eseguita l'azione WriteEnvironmentStrings o 'azione RemoveEnvironmentStrings. In Windows 2000, Windows Server 2003, Windows XP e Windows Vista queste informazioni vengono archiviate nel Registro di sistema e viene inviato un messaggio WM_SETTINGCHANGE per notificare al sistema le modifiche al termine dell'installazione. Un altro processo può ricevere una notifica delle modifiche gestendo questi messaggi. Non viene inviato alcun messaggio se il riavvio del sistema è in sospeso. Un pacchetto può usare la proprietà MsiSystemRebootPending per verificare se un riavvio del sistema è in sospeso.
Il programma di installazione esegue l'azione WriteEnvironmentStrings solo durante l'installazione o la reinstallazione di un componente ed esegue l'azione RemoveEnvironmentStrings solo durante la rimozione di un componente.
I valori vengono scritti o rimossi in base alla selezione di azioni e modificatori primari. Questi sono descritti nella sezione Messaggi ActionData seguenti. Si noti che a seconda dell'azione specificata, WriteEnvironmentStrings può rimuovere le variabili e RemoveEnvironmentStrings può aggiungerle in base alla creazione della tabella Environment.
Restrizioni di sequenza
L'azione InstallValidate deve essere eseguita prima dell'azione RemoveEnvironmentStrings. Poiché l'azione WriteEnvironmentStrings e l'azione RemoveEnvironmentStrings non vengono mai applicate durante un'installazione o la rimozione di un componente, la relativa sequenza non è limitata.
Messaggi ActionData
Campo | Descrizione dei dati delle azioni |
---|---|
[1] | Nome della variabile di ambiente da modificare. |
[2] | Valore della variabile di ambiente. |
[3] | Si tratta di un campo di flag di bit che specifica l'azione da eseguire. Includere un solo bit per un'azione primaria. In questo campo possono essere inclusi più di un bit di modificatore. Consultare le descrizioni dei flag di bit seguenti. |
Valore bit | Descrizione delle azioni principali |
---|---|
0x1 | Insieme. Imposta il valore della variabile di ambiente in tutti i casi. Se questo bit viene combinato con un bit di modifica Append o Prefix, l'azione aggiunge il valore a qualsiasi valore esistente nella variabile. |
0x2 | Impostare. Imposta il valore se la variabile è assente. Se questo bit viene combinato con un bit di modifica Append o Prefix, l'azione aggiunge il valore a qualsiasi valore esistente nella variabile. |
0x4 | Togliere. Rimuove il valore dalla variabile. Se questo bit viene combinato con un bit di modifica Append o Prefix, il valore viene rimosso dalla stringa esistente, se il valore esiste. |
Il valore del bit | Descrizione del modificatore |
---|---|
0x20000000 | Se questo bit è impostato, le azioni vengono applicate alle variabili di ambiente del computer. Se questo bit non è impostato, le azioni vengono applicate alle variabili di ambiente dell'utente. |
0x40000000 | Aggiungere. Questo bit è facoltativo. Non impostare sia il modificatore di accodamento che il prefisso. |
0x80000000 | Prefisso. Questa parte è facoltativa. Non impostare sia il modificatore di appendi che quello di prefisso. |