Benutzerdefinierter Aktionstyp 18
Diese benutzerdefinierte Aktion ruft eine ausführbare Datei auf, die mit einer Befehlszeile gestartet wird.
Quelle
Die ausführbare Datei wird aus einer Datei generiert, die mit der Anwendung installiert ist. Das Quellfeld der CustomAction-Tabelle enthält einen Schlüssel zur Dateitabelle. Der Speicherort des benutzerdefinierten Aktionscodes wird durch die Auflösung des Zielpfads für diese Datei bestimmt. Daher muss diese benutzerdefinierte Aktion aufgerufen werden, nachdem die Datei installiert wurde und bevor sie entfernt wird.
Typwert
Fügen Sie den folgenden Wert in die Spalte "Typ" der CustomAction-Tabelle ein, um den grundlegenden numerischen Typ anzugeben.
| Konstanten | Hexadezimal | Dezimal |
|---|---|---|
| msidbCustomActionTypeExe + msidbCustomActionTypeSourceFile- | 0x012 | 18 |
Ziel
Die Zielspalte der CustomAction-Tabelle enthält die Befehlszeilenzeichenfolge für die in der Spalte "Quelle" identifizierte ausführbare Datei.
Rückgabeverarbeitungsoptionen
Fügen Sie optionale Flagbits in die Spalte "Typ" der CustomAction-Tabelle ein, um Rückgabeverarbeitungsoptionen anzugeben. Eine Beschreibung der Optionen und werte finden Sie unter Benutzerdefinierte Aktion Rückgabeverarbeitungsoptionen.
Ausführungsplanungsoptionen
Fügen Sie optionale Flagbits in die Spalte "Typ" der CustomAction-Tabelle ein, um Ausführungsplanungsoptionen anzugeben. Diese Optionen steuern die mehrfache Ausführung von benutzerdefinierten Aktionen. Eine Beschreibung der Optionen finden Sie unter Benutzerdefinierte Optionen für die Ausführung von Aktionen.
In-Script Ausführungsoptionen
Fügen Sie optionale Flagbits in die Spalte "Typ" der CustomAction-Tabelle ein,, um eine In-Script-Ausführungsoption anzugeben. Mit diesen Optionen wird der Aktionscode in das Ausführungs-, Rollback- oder Commitskript kopiert. Eine Beschreibung der Optionen finden Sie unter Benutzerdefinierte Aktion In-Script Ausführungsoptionen.
Rückgabewerte
Benutzerdefinierte Aktionen, die ausführbare Dateien sind, müssen den Wert 0 für den Erfolg zurückgeben. Der Installer interpretiert jeden anderen Rückgabewert als Fehler. Um Rückgabewerte zu ignorieren, legen Sie die msidbCustomActionTypeContinue Bitkennzeichnung im Feld "Typ" 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 dies auch eine benutzerdefinierte Ausführungsaktionist, verwendet das Installationsprogramm CreateProcessAsUser- oder CreateProcess-, um den Prozess zu erstellen, wenn die benutzerdefinierte Aktion über das Installationsskript aufgerufen wird.
Benutzerdefinierte Aktionen, die auf eine installierte Datei als Quelle verweisen, wie z. B. Custom Action Type 18 (EXE), müssen die folgenden Sequenzierungseinschränkungen einhalten:
- Die benutzerdefinierte Aktion muss nach der CostFinalize-Aktionsequenziert werden. Dies ist so, dass die benutzerdefinierte Aktion den Pfad auflösen kann, der zum Suchen der EXE erforderlich ist.
- Wenn die Quelldatei noch nicht auf dem Computer installiert ist, müssen benutzerdefinierte Aktionen dieses Typs nach der InstallFiles-Aktionsequenziert werden.
- Wenn die Quelldatei noch nicht auf dem Computer installiert ist, müssen nicht verzögerte benutzerdefinierte Aktionen dieses Typs nach der InstallFinalize-Aktionsequenziert werden.
Verwandte Themen