Benutzerdefinierter Aktionstyp 19

Diese benutzerdefinierte Aktion zeigt eine festgelegte Fehlermeldung an, gibt einen Fehler zurück und beendet dann die Installation. Die angezeigte Fehlermeldung kann als Zeichenfolge oder als Index in der Tabelle „Error“ angegeben werden.

`Source`

Lassen Sie die Spalte „Source“ der Tabelle „CustomAction“ leer.

„Type“-Wert

Geben Sie den folgenden Wert in die Spalte „Type“ der Tabelle „CustomAction“ ein, um den grundlegenden numerischen Typ anzugeben.

Konstanten Hexadezimal Decimal
msidbCustomActionTypeTextData + msidbCustomActionTypeSourceFile 0x013 19

 

Ziel

Die Spalte „Target“ der Tabelle „CustomAction“ enthält eine Textzeichenfolge, die mit der in MsiFormatRecord festgelegten Funktionalität formatiert ist (ohne die numerischen Feldspezifizierer). Zu ersetzende Parameter sind in eckige Klammern [...] eingeschlossen. Sie können Eigenschaften, Umgebungsvariablen (Präfix %), Dateipfade (Präfix #) oder Komponenten-Verzeichnispfade (Präfix $) sein. Wenn die Zeichenfolge nach der Formatierung als Ganzzahl ausgewertet wird, wird diese Ganzzahl als Index für die Tabelle „Error“ verwendet, um die anzuzeigende Meldung abzurufen. Wenn die Zeichenfolge nach der Formatierung nicht-numerische Zeichen enthält, wird die Zeichenfolge selbst als Meldung angezeigt.

Optionen für die Rückgabeverarbeitung

Die benutzerdefinierte Aktion verwendet keine Optionen.

Optionen für die Ausführungsplanung

Die benutzerdefinierte Aktion verwendet keine Optionen.

Optionen für die In-Script-Ausführung

Die benutzerdefinierte Aktion verwendet keine Optionen.

Rückgabewerte

Weitere Informationen finden Sie unter Rückgabewerte für benutzerdefinierte Aktionen.

Bemerkungen

Beispielsweise geben die benutzerdefinierten Aktionen CAError1, CAError2, CAError3 und CAError4 die folgenden Meldungen zurück.

Tabelle „CustomAction“

Aktion type `Source` Ziel
CAError1 19 [Prop1]
CAError2 19 Installation wegen Error2 fehlgeschlagen.
CAError3 19 25000
CAError4 19 [Prop2]

 

Tabelle „Property“

Eigenschaft Wert
Prop1 "Installation wegen Error1 fehlgeschlagen."
Prop2 "25100"

 

Tabelle „Error“

Code `Message`
25000 Installation wegen Error3 fehlgeschlagen.
25100 Installation wegen Error4 fehlgeschlagen.

 

Diese benutzerdefinierten Aktionen geben die folgenden Fehlermeldungen zurück:

Benutzerdefinierte Aktion Zeichenfolge der zurückgegebenen Meldung
CAError1 Installation wegen Error1 fehlgeschlagen.
CAError2 Installation wegen Error2 fehlgeschlagen.
CAError3 Installation wegen Error3 fehlgeschlagen.
CAError4 Installation wegen Error4 fehlgeschlagen.

 

Hinweis: Da die Reihenfolge, in der die Startbedingungen ausgewertet werden, nicht durch die Erstellung der Tabelle „LaunchCondition“ gewährleistet werden kann, sollten Sie bei Ihrer Installation den benutzerdefinierten Aktionstyp 19 verwenden, um die Bedingungen in einer bestimmten Reihenfolge auszuwerten.

Custom_Actions