Shortcut-Tabelle
In der Shortcut-Tabelle sind die Informationen enthalten, die die Anwendung zum Erstellen von Verknüpfungen auf dem Computer des Benutzers benötigt.
Die Shortcut-Tabelle umfasst die folgenden Spalten.
| Spalte | Typ | Schlüssel | Nullwerte zulässig |
|---|---|---|---|
| Verknüpfung | Identifier | J | N |
| Directory_ | Identifier | N | N |
| Name | Filename | N | N |
| Component_ | Identifier | N | N |
| Ziel | Tastenkombination | N | N |
| Argumente | Formatted | N | J |
| BESCHREIBUNG | Text | N | J |
| Hotkey | Integer | N | J |
| Icon_ | Identifier | N | J |
| IconIndex | Integer | N | J |
| ShowCmd | Integer | N | J |
| WkDir | Identifier | N | J |
| DisplayResourceDLL | Formatted | N | J |
| DisplayResourceId | Integer | N | J |
| DescriptionResourceDLL | Formatted | N | J |
| DescriptionResourceId | Integer | N | J |
Spalten
-
Shortcut
-
Der Schlüsselwert für diese Tabelle.
-
Directory_
-
Der externe Schlüssel in die erste Spalte der Directory-Tabelle. Diese Spalte gibt das Verzeichnis an, in dem die Verknüpfungsdatei erstellt wird.
-
Name
-
Der lokalisierbare Name der zu erstellenden Verknüpfung.
-
Component_
-
Der externe Schlüssel in die erste Spalte der Component-Tabelle. Das Installationsprogramm verwendet den Installationsstatus der in dieser Spalte angegebenen Komponente, um zu bestimmen, ob die Verknüpfung erstellt oder gelöscht wird. Diese Komponente muss über einen gültigen Schlüsselpfad verfügen, damit die Verknüpfung installiert werden kann. Wenn die Target-Spalte den Namen eines Features enthält, ist die durch die Verknüpfung gestartete Datei die Schlüsseldatei der in dieser Spalte aufgeführten Komponente.
-
Target
-
Das Verknüpfungsziel.
Für eine angekündigte Verknüpfung muss diese Spalte ein externer Schlüssel in die erste Spalte der Feature-Tabelle sein. Das Installationsprogramm wertet den Eintrag im Target-Feld als Bezeichner aus, und der Eintrag muss ein gültiger Fremdschlüssel in die Feature-Tabelle sein. Die durch die Verknüpfung gestartete Datei ist in diesem Fall die Schlüsseldatei der Komponente, die in der Component_-Spalte aufgeführt ist. Wenn die Verknüpfung aktiviert ist, überprüft das Installationsprogramm, ob alle Komponenten im Feature installiert sind, bevor diese Datei gestartet wird.
Bei einer nicht angekündigten Verknüpfung wertet das Installationsprogramm dieses Feld als formatierte Zeichenfolge aus. Das Feld sollte einen Eigenschaftsbezeichner enthalten, der in eckigen Klammern ([ ]) steht und in die Datei oder einen Ordner erweitert wird, auf den die Verknüpfung verweist. Weitere Informationen finden Sie unter CreateShortcuts-Aktion.
-
Arguments
-
Die Befehlszeilenargumente für die Verknüpfung.
Beachten Sie, dass die Auflösung der Eigenschaften im Arguments-Feld eingeschränkt ist. Eine Eigenschaft, die in diesem Feld als [Eigenschaft] formatiert ist, kann nur aufgelöst werden, wenn die Eigenschaft bereits über den beabsichtigten Wert verfügt, wenn die Komponente installiert wird, zu der die Verknüpfung gehört. Um beispielsweise in den richtigen Wert für das Argument „[#MyDoc.doc]“ aufzulösen, muss derselbe Prozess die MyDoc.doc-Datei und die Komponente installieren, zu der die Verknüpfung gehört.
-
Description
-
Die lokalisierbare Beschreibung der Verknüpfung.
-
Hotkey
-
Der Hotkey für die Verknüpfung. Das niederwertige Byte enthält den virtuellen Schlüsselcode für den Schlüssel, und das höherwertige Byte enthält Modifiziererflags. Dieser Wert muss eine nicht negative Zahl sein. Erstellern von Installationspaketen wird im Allgemeinen empfohlen, diese Option nicht festzulegen, da die Einstellung dieser Option doppelte Hotkeys zum Desktop eines Benutzers hinzufügen kann. Darüber hinaus kann das Zuweisen von Hotkeys für Verknüpfungen für Benutzer problematisch sein, die Hotkeys für die Barrierefreiheit verwenden.
-
Icon_
-
Der externe Schlüssel zur ersten Spalte der Icon-Tabelle.
-
IconIndex
-
Der Symbolindex für die Verknüpfung. Dieser Wert muss eine nicht negative Zahl sein.
-
ShowCmd
-
Der Anzeigebefehl für das Anwendungsfenster.
Die folgenden Werte können verwendet werden. Die Werte sind mit denen identisch, die für die ShowWindow-Funktion der Windows-API definiert sind.
Wert Bedeutung 1 SW_SHOWNORMAL 3 SW_SHOWMAXIMIZED 7 SW_SHOWMINNOACTIVE -
WkDir
-
Der Name der Eigenschaft, die den Pfad des Arbeitsverzeichnisses für die Verknüpfung enthält. Der Wert kann das Windows-Format zum Verweisen auf Umgebungsvariablen verwenden, z. B. %USERPROFILE%. Die Verweise werden in einen tatsächlichen Pfad aufgelöst, wenn das Installationsprogramm das Arbeitsverzeichnis auflöst, um die Verknüpfung zu erstellen.
-
DisplayResourceDLL
-
Dieses Feld enthält einen formatierten Zeichenfolgenwert für den vollständigen Pfad zur sprachneutralen portablen ausführbaren Datei (LN-Datei), die die Daten der Ressourcenkonfiguration (RC Config) enthält. Die formatierte Zeichenfolge kann die [#filekey]-Konvention verwenden. Wenn dieses Feld einen Wert enthält, wird die Name-Spalte ignoriert. Wenn dieses Feld leer ist, verwendet das Installationsprogramm den Wert in der Name-Spalte. Wenn dieses Feld einen Wert enthält, muss auch das DisplayResourceId-Feld einen Wert enthalten, da die Installation sonst fehlschlägt.
Diese Spalte der Shortcut-Tabelle wird nur unter Windows Vista oder Windows Server 2008 verwendet und andernfalls ignoriert. Diese Spalte ist nicht bei Versionen vor Windows Installer 4.0 verfügbar.
Informationen zum Hinzufügen von Verknüpfungen zur Shortcut-Tabelle für die Verwendung mit MUI-Ressourcen finden Sie im Beispiel für eine MUI-Verknüpfung.
-
DisplayResourceId
-
Der Anzeigenamensindex für die Verknüpfung. Dieser Wert muss eine nicht negative Zahl sein. Wenn dieses Feld einen Wert enthält, muss auch das DisplayResourceDLL-Feld einen Wert enthalten, da die Installation sonst fehlschlägt.
Diese Spalte der Shortcut-Tabelle wird nur unter Windows Vista oder Windows Server 2008 verwendet und andernfalls ignoriert. Diese Spalte ist nicht bei Versionen vor Windows Installer 4.0 verfügbar.
-
DescriptionResourceDLL
-
Dieses Feld enthält einen formatierten Zeichenfolgenwert für den vollständigen Pfad zur sprachneutralen portablen ausführbaren Datei (LN-Datei), die die Daten der Ressourcenkonfiguration (RC Config) enthält. Die formatierte Zeichenfolge kann die [#filekey]-Konvention verwenden. Wenn dieses Feld einen Wert enthält, wird die Name-Spalte ignoriert. Wenn dieses Feld leer ist, verwendet das Installationsprogramm den Wert in der Description-Spalte. Wenn dieses Feld einen Wert enthält, muss auch das DescriptionResourceId-Feld einen Wert enthalten, da die Installation sonst fehlschlägt.
Diese Spalte der Shortcut-Tabelle wird nur unter Windows Vista oder Windows Server 2008 verwendet und andernfalls ignoriert. Diese Spalte ist nicht bei Versionen vor Windows Installer 4.0 verfügbar.
Informationen zum Hinzufügen von Verknüpfungen zur Shortcut-Tabelle für die Verwendung mit MUI-Ressourcen finden Sie im Beispiel für eine MUI-Verknüpfung.
-
DescriptionResourceId
-
Der Beschreibungsnamensindex für die Verknüpfung. Dieser Wert muss eine nicht negative Zahl sein. Wenn dieses Feld einen Wert enthält, muss auch das DescriptionResourceDLL-Feld einen Wert enthalten, da die Installation sonst fehlschlägt.
Diese Spalte der Shortcut-Tabelle wird nur unter Windows Vista oder Windows Server 2008 verwendet und andernfalls ignoriert. Diese Spalte ist nicht bei Versionen vor Windows Installer 4.0 verfügbar.
Bemerkungen
Durch die Aktivierung eines Features wird nur dann eine angekündigte Verknüpfung erstellt, wenn die IShellLink-Schnittstelle des Systems die Auflösung des Installationsdeskriptors unterstützt. Dies wird von Microsoft Windows 2000 und Systemen unterstützt, auf denen Microsoft Internet Explorer 4.01 ausgeführt wird. Wenn dies nicht unterstützt wird, erstellt das Installationsprogramm bei der lokal oder ausgehend von der Quelle ausgeführten Installation der Komponente des Features eine nicht angekündigte Verknüpfung.
Beachten Sie, dass angekündigte Verknüpfungen immer auf eine bestimmte Anwendung zeigen, die durch einen Produktcode identifiziert wird und nicht von Anwendungen gemeinsam verwendet werden dürfen. Angekündigte Verknüpfungen funktionieren nur für die zuletzt installierte Anwendung und werden entfernt, wenn diese Anwendung entfernt wird.
Auf diese Tabelle wird verwiesen, wenn die CreateShortcuts-Aktion bzw. die RemoveShortcuts-Aktion ausgeführt wird.
Siehe auch DISABLEADVTSHORTCUTS-Eigenschaft.
Überprüfen