Benutzerdefinierter Aktionstyp 39
Der benutzerdefinierte Aktionstyp 39 wird mit gleichzeitigen Installationen verwendet. Gleichzeitige Installationen werden nicht für die Installation von Anwendungen empfohlen, die für die Veröffentlichung für die Öffentlichkeit vorgesehen sind. Informationen zu gleichzeitigen Installationen finden Sie unter Gleichzeitige Installationen.
Typ 39 benutzerdefinierte Aktion installiert eine Anwendung, die angekündigt oder bereits installiert ist. Dieser benutzerdefinierte Aktionstyp kann verwendet werden, um ein Produkt neu zu installieren oder zu entfernen, das durch das Installationspaket des aktuellen Produkts als gleichzeitige Installation installiert wurde. Die benutzerdefinierte Aktion "Typ 39" kann nicht verwendet werden, um zuvor installierte Produkte auf andere Weise neu zu installieren oder zu entfernen. Wenn das sekundäre Produkt beispielsweise mit einem Typ 39, Typ 23 oder Typ 7 während der Installation des primären Produkts installiert wird, kann eine benutzerdefinierte Aktion vom Typ 39 verwendet werden, um das sekundäre Produkt zu entfernen, wenn das primäre Produkt deinstalliert wird.
Quelle
Das Quellfeld der CustomAction-Tabelle enthält den Produktcode für die Anwendung.
Numerischer Typ
| Typname | Wert |
|---|---|
| msidbCustomActionTypeInstall + msidbCustomActionTypeDirectory | 39 |
Ziel
Das Zielfeld der CustomAction-Tabelle enthält Eigenschafteneinstellungen, die an die gleichzeitige Installation übergeben werden sollen. Diese Eigenschafteneinstellungen können Features angeben.
Rückgabeverarbeitungsoptionen
Der benutzerdefinierte Aktionstyp 39 schlägt fehl, wenn die Anwendung nicht angekündigt oder installiert ist. Um diesen Fehler zu vermeiden, müssen Sie die msidbCustomActionTypeContinueflagfestlegen.
Eine gleichzeitige Installation kann nicht asynchron ausgeführt werden.
Siehe benutzerdefinierte Aktion Rückgabeverarbeitungsoptionen.
Ausführungsplanungsoptionen
Optionskennzeichnungen stehen zur Verfügung, um die potenzielle mehrfache Ausführung von benutzerdefinierten Aktionen zu steuern. Weitere Informationen finden Sie unter benutzerdefinierten Optionen für die Ausführung von Aktionen.
In-Script Ausführungsoptionen
Die benutzerdefinierte Aktion verwendet diese Option nicht.
Rückgabewerte
Der Rückgabestatus des Beendens, Fehlers, Anhaltens oder Erfolgs einer gleichzeitigen Installation wird auf die gleiche Weise wie jede andere Aktion verarbeitet. Beachten Sie jedoch, dass Windows Installer die Rückgabewerte aus allen Aktionen übersetzt, wenn der Rückgabewert in die Protokolldatei geschrieben wird. Wenn der Rückgabewert der Aktion beispielsweise in der Protokolldatei als 1 angezeigt wird, bedeutet dies, dass die zurückgegebene Aktion ERROR_SUCCESS. Weitere Informationen finden Sie unter Protokollierung von Aktionsrücklaufwerten.
Beachten Sie, dass, wenn eine gleichzeitige Installation msidbCustomActionTypeContinue festgelegt hat, eine Rückgabe von ERROR_INSTALL_USEREXIT, ERROR_INSTALL_REBOOT, ERROR_INSTALL_REBOOT_NOW oder ERROR_SUCCESS_REBOOT_REQUIRED als ERROR_SUCCESS behandelt wird. Wenn Sie msidbCustomActionTypeContinue festlegen und die gleichzeitige Installation einen Neustart erfordert, wird die Anforderung für den Neustart ignoriert. Darüber hinaus wird der Fehlercode aus der benutzerdefinierten Aktion der gleichzeitigen Installation ignoriert.
Wenn msidbCustomActionTypeContinue nicht festgelegt ist, werden die folgenden Rückgabecodes plus ERROR_SUCCESS als Erfolg behandelt und haben die folgenden Bedeutungen. Andere Rückgabecodes werden als Fehler behandelt.
| Nachricht | Bedeutung |
|---|---|
| ERROR_INSTALL_REBOOT | Das Neustartflagge wird am Ende der Installation neu gestartet. |
| ERROR_INSTALL_REBOOT_NOW | Vor Abschluss der Installation ist ein Neustart erforderlich. Der Neustart wird sofort verarbeitet. |
| ERROR_SUCCESS_REBOOT_REQUIRED | Ein Neustart war erforderlich, wurde jedoch unterdrückt. |
Bemerkungen
Ein bedingter Ausdruck ist erforderlich, um die gleichzeitige Installation entweder bei der Installation oder entfernung der zugehörigen Komponente oder des zugehörigen Features zu aktivieren.
Verwandte Themen