Benutzerdefinierter Aktionstyp 34
Diese benutzerdefinierte Aktion ruft eine ausführbare Datei auf, die mit einer Befehlszeile gestartet wird. Weitere Informationen finden Sie unter Ausführbare Dateien.
`Source`
Die ausführbare Datei wird aus einer Datei generiert. Das Feld „Source“ der Tabelle CustomAction enthält einen Schlüssel für die Tabelle Directory. Der referenzierte Eintrage in der Tabelle „Directory“ wird verwendet, um den vollständigen Pfad zu einem Arbeitsverzeichnis aufzulösen. Dies muss nicht der Pfad zu dem Verzeichnis sein, in dem sich die ausführbare Datei befindet.
Type-Wert
Fügen Sie den folgenden Wert in die Spalte „Type“ der Tabelle CustomAction ein, um den grundlegenden numerischen Typ anzugeben.
| Konstanten | Hexadezimal | Decimal |
|---|---|---|
| msidbCustomActionTypeExe + msidbCustomActionTypeDirectory | 0x022 | 34 |
Ziel
Die Spalte „Target“ der Tabelle CustomAction enthält den vollständigen Pfad und den Namen der ausführbaren Datei gefolgt von optionalen Argumenten für die ausführbare Datei. Der vollständige Pfad und der Name der ausführbaren Datei sind erforderlich. Lange Dateinamen oder Pfade müssen in Anführungszeichen eingeschlossen werden. Der Wert wird als formatierter Text behandelt und kann Verweise auf Eigenschaften, Dateien, Verzeichnisse oder andere formatierte Textattribute enthalten.
Optionen für die Rückgabeverarbeitung
Fügen Sie optionale Flagbits in die Spalte „Type“ der Tabelle CustomAction ein, um Optionen für die Rückgabeverarbeitung anzugeben. Eine Beschreibung der Optionen und Werte finden Sie unter Optionen für die Rückgabeverarbeitung von benutzerdefinierten Aktionen.
Optionen für die Ausführungsplanung
Fügen Sie optionale Flagbits in die Spalte „Type“ der Tabelle CustomAction ein, um Optionen für die Ausführungsplanung anzugeben. Diese Optionen steuern die mehrfache Ausführung benutzerdefinierter Aktionen. Eine Beschreibung der Optionen finden Sie unter Optionen für die Ausführungsplanung benutzerdefinierter Aktionen.
Optionen für die skriptinterne Ausführung
Fügen Sie optionale Flagbits in die Spalte „Type“ der Tabelle CustomAction ein, um Optionen für die skriptinterne Ausführung anzugeben. Diese Optionen kopieren den Aktionscode in das Ausführungs-, Rollback- oder Commitskript. Eine Beschreibung der Optionen finden Sie unter Optionen für die skriptinterne Ausführung von benutzerdefinierten Aktionen.
Rückgabewerte
Benutzerdefinierte Aktionen, die ausführbare Dateien sind, müssen den Wert 0 zurückgeben, um erfolgreich zu sein. Das Installationsprogramm behandelt jeden anderen Rückgabewert als Fehler. Um Rückgabewerte zu ignorieren, legen Sie das Bitflag msidbCustomActionTypeContinue im Feld „Type“ der Tabelle CustomAction fest.
Bemerkungen
Für benutzerdefinierte Aktionen, die eine ausführbare Datei starten, ist eine Befehlszeile erforderlich, die häufig dynamisch festgelegte Eigenschaften enthält. Wenn dies auch eine verzögert auszuführende benutzerdefinierte Aktion ist, erstellt das Installationsprogramm den Prozess beim Aufrufen der benutzerdefinierten Aktion über das Installationsskript über CreateProcessAsUser oder CreateProcess.
Zugehörige Themen