Azione WriteEnvironmentStrings

  • Articolo

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 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 di WM_SETTINGCHANGE per notificare al sistema le modifiche al termine dell'installazione. Un altro processo può ricevere una notifica delle modifiche gestendo questi messaggi. Se il riavvio del sistema non è in sospeso, non viene inviato alcun messaggio. Un pacchetto può utilizzare 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. Queste informazioni sono descritte nella sezione Messaggi ActionData seguente. 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 della sequenza

L'azione InstallValidate deve essere eseguita prima dell'azione RemoveEnvironmentStrings. Poiché l'azione WriteEnvironmentStrings e RemoveEnvironmentStrings non vengono mai applicate entrambe 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 modifica. Vedere le descrizioni dei flag di bit seguenti.

 

Valore bit Descrizione delle azioni primarie
0x1 Ai posti. 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 Ai posti. 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 Rimuovi. 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.

 

Valore 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 Append. Questo bit è facoltativo. Non impostare i modificatori Append e Prefix.
0x80000000 Prefisso. Questo bit è facoltativo. Non impostare i modificatori Append e Prefix.