ショートカット テーブル
ショートカット テーブルには、アプリケーションがユーザーのコンピューターにショートカットを作成するために必要な情報が保持されます。
ショートカット テーブルには、次の列があります。
| コラム | 種類 | 鍵 | 許容 |
|---|---|---|---|
| 近道 | 識別子の | Y | N |
| ディレクトリ_ | 識別子の | N | N |
| 名前 | ファイル名の | N | N |
| コンポーネント_ | 識別子の | N | N |
| ターゲット | ショートカット | N | N |
| 引数 | 書式設定された | N | Y |
| 形容 | テキスト | N | Y |
| ホットキー | 整数 の | N | Y |
| アイコン_ | 識別子の | N | Y |
| IconIndex | 整数 の | N | Y |
| ShowCmd | 整数 の | N | Y |
| WkDir | 識別子の | N | Y |
| DisplayResourceDLL | 書式設定された | N | Y |
| DisplayResourceId | 整数 の | N | Y |
| DescriptionResourceDLL | 書式設定された | N | Y |
| DescriptionResourceId | 整数 の | N | Y |
列
-
ショートカット
-
このテーブルのキー値。
-
Directory_
-
Directory テーブルの最初の列への外部キー。 この列は、ショートカット ファイルが作成されるディレクトリを指定します。
-
名
-
作成するショートカットのローカライズ可能な名前。
-
Component_
-
コンポーネント テーブルの最初の列への外部キー。 インストーラーは、この列で指定されたコンポーネントのインストール状態を使用して、ショートカットが作成されるか削除されるかを判断します。 このコンポーネントには、ショートカットをインストールするための有効なキー パスが必要です。 ターゲット列にフィーチャーの名前が含まれている場合、ショートカットによって起動されるファイルは、この列にリストされているコンポーネントのキー ファイルです。
-
ターゲット
-
ショートカット ターゲット。
アドバタイズされたショートカットの場合、この列は、Feature テーブルの最初の列の外部キーである必要があります。 インストーラーは[ターゲット]フィールドのエントリを 識別子 として評価し、エントリは フィーチャー テーブルの有効な外部キーである必要があります。 この場合、ショートカットによって起動されるファイルは、Component_列に表示されるコンポーネントのキー ファイルです。 ショートカットがアクティブになると、インストーラーは、このファイルを起動する前に、機能内のすべてのコンポーネントがインストールされていることを確認します。
アドバタイズされていないショートカットの場合、インストーラーはこのフィールドを Formatted 文字列として評価します。 フィールドには、角かっこ ([ ]) で囲まれたプロパティ識別子が含まれている必要があります。この識別子は、ファイルまたはショートカットが指すフォルダーに展開されます。 詳細については、CreateShortcuts アクション を参照してください。
-
引数
-
ショートカットのコマンド ライン引数。
[引数] フィールドのプロパティの解像度は制限されることに注意してください。 このフィールドの [Property] として書式設定されたプロパティは、ショートカットを所有するコンポーネントがインストールされている場合に、プロパティに既に目的の値がある場合にのみ解決できます。 たとえば、引数 "[#MyDoc.doc]" の正しい値に解決するには、同じプロセスでファイル MyDoc.docとショートカットを所有するコンポーネントをインストールする必要があります。
-
の説明
-
ショートカットのローカライズ可能な説明。
-
ホットキー
-
ショートカットのホットキー。 下位バイトにはキーの仮想キー コードが含まれており、上位バイトには修飾子フラグが含まれます。 これは負以外の数値である必要があります。 インストール パッケージの作成者は通常、このオプションを設定しないことをお勧めします。このオプションを設定すると、ユーザーのデスクトップに重複するホットキーが追加される可能性があるためです。 さらに、ショートカットにホットキーを割り当てる方法は、ユーザーが アクセシビリティにホットキーを使用している場合に問題になる可能性があります。
-
Icon_
-
IconIndex
-
ショートカットのアイコン インデックス。 これは負以外の数値である必要があります。
-
ShowCmd の
-
アプリケーション ウィンドウの [表示] コマンド。
次の値を使用できます。 値は、Windows API 関数 ShowWindow に対して定義されています。
価値 意味 1 SW_SHOWNORMAL 3 SW_SHOWMAXIMIZED 7 SW_SHOWMINNOACTIVE -
WkDir
-
ショートカットの作業ディレクトリのパスを持つプロパティの名前。 この値は、Windows 形式を使用して環境変数 (%USERPROFILE%など) を参照できます。 インストーラーが作業ディレクトリを解決してショートカットを作成すると、参照は実際のパスに解決されます。
-
DisplayResourceDLL の
-
このフィールドには、リソース構成 (RC Config) データを含む言語に依存しないポータブル実行可能ファイル (LN ファイル) への完全パスの 書式設定された 文字列値が含まれます。 書式設定された文字列では、[#filekey] 規則を使用できます。 このフィールドに値が含まれている場合、Name 列は無視されます。 このフィールドが空の場合、インストーラーは [名前] 列の値を使用します。 このフィールドに値が含まれている場合、DisplayResourceId フィールドにも値を含める必要があります。または、インストールが失敗します。
ショートカット テーブルのこの列は、Windows Vista または Windows Server 2008 で実行されている場合にのみ使用され、それ以外の場合は無視されます。 この列は、Windows インストーラー 4.0 より前のバージョンで使用できます。
MUI リソースで使用するショートカット テーブルにショートカットを追加する方法については、「MUI ショートカットの例を参照してください。
-
DisplayResourceId の
-
ショートカットの表示名インデックス。 これは負以外の数値である必要があります。 このフィールドに値が含まれている場合、DisplayResourceDLL フィールドにも値を含める必要があります。または、インストールが失敗します。
ショートカット テーブルのこの列は、Windows Vista または Windows Server 2008 で実行されている場合にのみ使用され、それ以外の場合は無視されます。 この列は、Windows インストーラー 4.0 より前のバージョンで使用できます。
-
DescriptionResourceDLL
-
このフィールドには、リソース構成 (RC Config) データを含む言語に依存しないポータブル実行可能ファイル (LN ファイル) への完全パスの 書式設定された 文字列値が含まれます。 書式設定された文字列では、[#filekey] 規則を使用できます。 このフィールドに値が含まれている場合、Name 列は無視されます。 このフィールドが空の場合、インストーラーは [説明] 列の値を使用します。 このフィールドに値が含まれている場合、DescriptionResourceId フィールドにも値を含める必要があります。または、インストールが失敗します。
ショートカット テーブルのこの列は、Windows Vista または Windows Server 2008 で実行されている場合にのみ使用され、それ以外の場合は無視されます。 この列は、Windows インストーラー 4.0 より前のバージョンで使用できます。
MUI リソースで使用するショートカット テーブルにショートカットを追加する方法については、「MUI ショートカットの例を参照してください。
-
DescriptionResourceId
-
ショートカットの説明名インデックス。 これは負以外の数値である必要があります。 このフィールドに値が含まれている場合、DescriptionResourceDLL フィールドにも値を含める必要があります。または、インストールが失敗します。
ショートカット テーブルのこの列は、Windows Vista または Windows Server 2008 で実行されている場合にのみ使用され、それ以外の場合は無視されます。 この列は、Windows インストーラー 4.0 より前のバージョンで使用できます。
備考
機能を有効にすると、システムの IShellLink インターフェイスでインストーラー記述子の解決がサポートされている場合にのみ、アドバタイズされたショートカットが作成されます。 これは、Microsoft Windows 2000 および Microsoft Internet Explorer 4.01 を実行しているシステムでサポートされています。 サポートされていない場合、インストーラーは、ローカルまたはソースから実行される機能のコンポーネントのインストール時に、アドバタイズされていないショートカットを作成します。
アドバタイズされたショートカットは常に特定のアプリケーションを指し示し、ProductCodeで識別され、アプリケーション間で共有することはできません。 アドバタイズされたショートカットは、最近インストールされたアプリケーションでのみ機能し、そのアプリケーションが削除されると削除されます。
このテーブルは、CreateShortcuts アクションが され、RemoveShortcuts アクション が実行されるときに参照されます。
DISABLEADVTSHORTCUTS プロパティも参照してください。
検証