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.
| Aktion | type | `Source` | Ziel |
|---|---|---|---|
| CAError1 | 19 | [Prop1] | |
| CAError2 | 19 | Installation wegen Error2 fehlgeschlagen. | |
| CAError3 | 19 | 25000 | |
| CAError4 | 19 | [Prop2] |
| Eigenschaft | Wert |
|---|---|
| Prop1 | "Installation wegen Error1 fehlgeschlagen." |
| Prop2 | "25100" |
| 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.
Zugehörige Themen