RemoveEnvironmentStrings 動作

RemoveEnvironmentStrings 巨集指令會修改環境變數的值。

請注意,執行 WriteEnvironmentStrings 巨集指令或 RemoveEnvironmentStrings 動作 時,安裝程式不會變更安裝環境變數。 在 Windows 2000 上,這項資訊會儲存在登錄中,並傳送訊息以在安裝完成時通知系統變更。 新的進程或檢查這些訊息的另一個進程,將會使用新的環境變數。

安裝程式只會在安裝或重新安裝元件期間執行 WriteEnvironmentStrings 動作 ,並且只在移除元件期間執行 RemoveEnvironmentStrings 動作。

值會根據選取主要動作和修飾詞來寫入或移除。 下列 ActionData Messages 一節會說明這些訊息。 請注意,視指定的動作而定,WriteEnvironmentStrings 可能會移除變數,而 RemoveEnvironmentStrings 可能會根據 Environment 資料表的撰寫來新增變數。

序列限制

InstallValidate 巨集指令必須在 RemoveEnvironmentStrings 動作之前執行。 由於 WriteEnvironmentStrings 巨集指令和 RemoveEnvironmentStrings 動作永遠不會在安裝或移除元件期間套用,因此不會限制其相對順序。

ActionData 訊息

欄位 動作資料的描述
 [1] 要修改的環境變數名稱。
[2] 環境變數值。
[3] 這是位旗標的欄位,指定要執行的動作。 只包含主要動作的一個位。 此欄位中可能包含一個以上的修飾詞位。 請參閱下列位旗標描述。

 

位元值 主要動作的描述
0x1 設定。 在所有情況下設定環境變數的值。
如果這個位與 Append 或 Prefix 修飾詞位結合,動作會將值新增至變數中的任何現有值。
0x2 設定。 如果變數不存在,請設定值。
如果這個位與 Append 或 Prefix 修飾詞位結合,動作會將值新增至變數中的任何現有值。
0x4 移除。 從變數中移除值。
如果這個位與 Append 或 Prefix 修飾詞位結合,如果值存在,就會從現有的字串中移除此值。

 

位元值 修飾詞的描述
0x20000000 如果設定此位,動作會套用至電腦環境變數。
如果未設定此位,動作會套用至使用者的環境變數。
0x40000000 Append。 這個位是選擇性的。 請勿同時設定 Append 和 Prefix 修飾詞。
0x80000000 首碼。 這個位是選擇性的。 請勿同時設定 Append 和 Prefix 修飾詞。