RemoveEnvironmentStrings アクション
RemoveEnvironmentStrings アクションは、環境変数の値を変更します。
WriteEnvironmentStrings アクション または RemoveEnvironmentStrings アクションが実行されている場合、インストール中の環境変数は変更されないことに注意してください。 Windows 2000 では、この情報はレジストリに格納され、インストールが完了したときにシステムに変更を通知するメッセージが送信されます。 新しいプロセスまたはこれらのメッセージをチェックする別のプロセスでは、新しい環境変数が使用されます。
インストーラーは、コンポーネントのインストールまたは再インストール中にのみ WriteEnvironmentStrings アクションを実行し、コンポーネントの削除中にのみ RemoveEnvironmentStrings アクションを実行します。
値は、プライマリ アクションと修飾子の選択に基づいて書き込まれるか削除されます。 これらは、次の ActionData メッセージ セクションで説明します。 指定されたアクションによっては、WriteEnvironmentStrings によって変数が削除される場合があり、RemoveEnvironmentStrings は、Environment テーブルの作成に基づいて変数を追加。
シーケンスの制限
InstallValidate アクション は、RemoveEnvironmentStrings アクションの前に実行する必要があります。 WriteEnvironmentStrings アクションと RemoveEnvironmentStrings アクションは、コンポーネントのインストール中または削除中に両方とも適用されないため、それらの相対シーケンスは制限されません。
ActionData メッセージ
畑 | アクション データの説明 |
---|---|
[1] | 変更する環境変数の名前。 |
[2] | 環境変数の値。 |
[3] | これは、実行するアクションを指定するビット フラグのフィールドです。 プライマリ アクションには 1 ビットのみを含めます。 このフィールドには、複数の修飾子ビットが含まれている可能性があります。 次のビット フラグの説明を参照してください。 |
ビット値 | 主なアクションの説明 |
---|---|
0x1 | セット。 すべてのケースで環境変数の値を設定します。 このビットが Append または Prefix 修飾子ビットと組み合わされている場合、アクションは変数内の既存の値に値を追加します。 |
0x2 | セット。 変数が存在しない場合に値を設定します。 このビットが Append または Prefix 修飾子ビットと組み合わされている場合、アクションは変数内の既存の値に値を追加します。 |
0x4 | 取り去る。 変数から値を削除します。 このビットが Append または Prefix 修飾子ビットと組み合わされている場合、値が存在する場合、値は既存の文字列から削除されます。 |
ビット値 | 修飾子の説明 |
---|---|
0x20000000 | このビットが設定されている場合、アクションはマシン環境変数に適用されます。 このビットが設定されていない場合、アクションはユーザーの環境変数に適用されます。 |
0x40000000 | 追加。 このビットは省略可能です。 Append 修飾子と Prefix 修飾子の両方を設定しないでください。 |
0x80000000 | 接頭辞。 このビットは省略可能です。 Append 修飾子と Prefix 修飾子の両方を設定しないでください。 |