以下のセクションは、すべての文字列、コマンド、パス設定中で利用可能な変数を 説明します。
これらの変数は、ブール演算子型や列挙型オプション中では サポートされていません。
パス変数
- #SYSTEMPATH
-
この文字列は、(GetSystemDirectory() API を使って)Windows システムディレクトリに 置き換えられます(たいてい C:\WINDOWS\System32 )。
- #WINDOWSPATH
-
この文字列は、(GetWindowsDirectory() API を使って)Windows ディレクトリに 置き換えられます(たいてい C:\WINDOWS )。
- #SYSTEMWINDOWSPATH
-
この文字列は、(GetSystemWindowsDirectory() API を使って)システム Windows ディレクトリに 置き換えられます(たいてい C:\WINDOWS )。
ターミナルサービスを実行しているシステムでは、それぞれのユーザーがユニークな Windows ディレクトリを持っています。
システム Windows ディレクトリは 全てのユーザーにより共有されるので、アプリケーションが 全てのユーザーに適用する初期設定とヘルプファイルを保管すべきディレクトリです。
ターミナルサービスでは、この変数がシステム Windows ディレクトリのパスである一方、#WINDOWSPATH 機能は 個々のユーザーにとってプライベートな Windows ディレクトリのパスです。
シングルユーザーシステムにおいて、これらの値は同じです。
- #APPPATH
-
セットアップ ブートストラッパーが実行されるフォルダ。他のすべてのパスが システムのカレントディレクトリに相対的です。
- #TEMPPATH
-
この文字列は、(GetTempPath() API を使って)temp ディレクトリに 置き換えられます(たいてい C:\Documents and Settings\[User]\Local Settings\Temp )。
- #GUID
- 各インストール インスタンスごとに 一意に生成された GUID 文字列。
- #CABPATH
-
もしあれば、埋め込まれた CAB が展開される場所。この値は #TEMPPATH\#GUID がデフォルトです。
セットアップ完了において成功か失敗かに関係なく、セットアップ コンフィギュレーション中で適切なオプションが選択された時に この場所は自動消去されます。
自動消去したいならば #CABPATH 中にテンポラリファイル(例えば CAB ファイル)を保存し、さもなければ #TEMPPATH にしなさい。
- #PID
-
カレント プロセス ID 。#GUID へのより短い代替案をファイル位置に提供します。
- #UILEVEL
-
現在のインストーラー UI レベル。"full", "silent", "basic" のうちの1つ。
- #LANGID
-
選択されたコンフィギュレーション言語 ID 。
コンフィギュレーションが定義された言語を持たない場合、これは空かもしれません。
- #LANGUAGE
-
選択されたコンフィギュレーション言語文字列。
コンフィギュレーションが定義された言語を持たない場合、これは空かもしれません。
環境変数
環境変数を、%VARIABLE% シンタックス、例えば %TEMP%
によって、代用できます。システムの場所のために環境変数を信頼する事は推奨されず、代わりに パス変数を使って下さい。
レジストリ値
レジストリ値を @[key(:options)\path(\value)(|key ...)(,default)] シンタックスによって 代用できます。
例えば @[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\CommonFilesDir,DefaultValue] 。
キーが存在する必要はなく、デフォルト値を指定する必要はなく 空とみなされます。
多数のキー パスが | で区切られているかも知れず、最初に見つかった値が使用されます。
レジストリから値が取得できなかった場合には デフォルト値が使用されます。
レジストリ パス内のキーの値はオプションで、バックスラッシュを持つ値なしでパスが終わる事を 確実にして下さい。
以下のオプションがサポートされています。詳細に関しては
Accessing an Alternate Registry View
を 見て下さい。
- WOW64_64
- 64ビットWindows上のアプリケーションが、64ビット レジストリ ビューに作用するはずである事を 示します。
- WOW64_32
- 64ビットWindows上のアプリケーションが、32ビット レジストリ ビューに作用するはずである事を 示します。
ユーザーコントロール変数
ユーザーコントロール変数を [VARIABLE] シンタックス、例えば [MYDIR] で、置き換える事ができます。
ユーザーコントロールにおける詳細は ユーザー定義コントロール を見て下さい。