Benutzerdefinierter Aktionstyp 34
Diese benutzerdefinierte Aktion ruft eine ausführbare Datei auf, die über eine Befehlszeile gestartet wurde. Weitere Informationen finden Sie unter Ausführbare Dateien.
Source
Die ausführbare Datei wird aus einer Datei generiert. Das Feld Quelle der Tabelle CustomAction enthält einen Schlüssel in der Directory-Tabelle. Der Verzeichnistabelleneintrag, auf den verwiesen wird, wird verwendet, um den vollständigen Pfad zu einem Arbeitsverzeichnis aufzulösen. Dies muss nicht der Pfad zum Verzeichnis sein, das die ausführbare Datei enthält.
Typwert
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 Namen der ausführbaren Datei, gefolgt von optionalen Argumenten für die ausführbare Datei. Der vollständige Pfad und Name der ausführbaren Datei ist erforderlich. Anführungszeichen müssen für lange Dateinamen oder Pfade verwendet 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 Benutzerdefinierte Optionen für die Aktionsrückgabeverarbeitung.
Optionen für die Ausführungsplanung
Fügen Sie optionale Flagbits in die Spalte Type der Tabelle CustomAction ein, um Ausführungszeitplanungsoptionen anzugeben. Diese Optionen steuern die mehrfache Ausführung von benutzerdefinierten Aktionen. Eine Beschreibung der Optionen finden Sie unter Custom Action Execution Scheduling Options.
In-Script Ausführungsoptionen
Fügen Sie optionale Flagbits in die Spalte Type der Tabelle CustomAction ein, um eine Skriptausführungsoption anzugeben. Diese Optionen kopieren den Aktionscode in das Ausführungs-, Rollback- oder Commitskript. Eine Beschreibung der Optionen finden Sie unter Benutzerdefinierte Aktion In-Script Ausführungsoptionen.
Rückgabewerte
Benutzerdefinierte Aktionen, bei denen es sich um ausführbare Dateien handelt, müssen für den Erfolg den Wert 0 zurückgeben. Das Installationsprogramm interpretiert alle anderen Rückgabewerte als Fehler. Um Rückgabewerte zu ignorieren, legen Sie das msidbCustomActionTypeContinue-Bitflag im Feld Type der CustomAction-Tabelle fest.
Bemerkungen
Eine benutzerdefinierte Aktion, die eine ausführbare Datei startet, verwendet eine Befehlszeile, die häufig Eigenschaften enthält, die dynamisch festgelegt werden. Wenn es sich auch um eine benutzerdefinierte Aktionmit verzögerter Ausführung handelt, verwendet das Installationsprogramm CreateProcessAsUser oder CreateProcess, um den Prozess zu erstellen, wenn die benutzerdefinierte Aktion aus dem Installationsskript aufgerufen wird.