Benutzerdefinierter Aktionstyp 39

Der benutzerdefinierte Aktionstyp 39 wird bei gleichzeitigen Installationen verwendet. Gleichzeitige Installationen werden nicht für die Installation von Anwendungen empfohlen, die für die Freigabe für die Öffentlichkeit bestimmt sind. Informationen zu gleichzeitigen Installationen finden Sie unter Gleichzeitige Installationen.

Eine benutzerdefinierte Aktion vom Typ 39 installiert eine Anwendung, die angekündigt oder bereits installiert ist. Mit diesem benutzerdefinierten Aktionstyp kann ein Produkt neu installiert oder entfernt werden, das als gleichzeitige Installation vom Installationspaket des aktuellen Produkts installiert wurde. Die benutzerdefinierte Aktion vom Typ 39 kann nicht verwendet werden, um ein zuvor auf andere Weise installiertes Produkt neu zu installieren oder zu entfernen. Wenn das sekundäre Produkt beispielsweise während der Installation des primären Produkts mithilfe einer benutzerdefinierten Aktion vom Typ 39, Typ 23 oder Typ 7 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.

`Source`

Das Source-Feld der CustomAction-Tabelle enthält den Produktcode für die Anwendung.

Numerischer Typ

Typname	Wert
msidbCustomActionTypeInstall + msidbCustomActionTypeDirectory	39

 

Ziel

Das Target-Feld der CustomAction-Tabelle enthält Eigenschafteneinstellungen, die an die gleichzeitige Installation übergeben werden sollen. Durch diese Eigenschafteneinstellungen können Features angegeben werden.

Optionen für die Rückgabeverarbeitung

Der benutzerdefinierte Aktionstyp 39 schlägt fehl, wenn die Anwendung nicht angekündigt oder installiert ist. Um diesen Fehler zu vermeiden, müssen Sie msidbCustomActionTypeContinueflag festlegen.

Eine gleichzeitige Installation kann nicht asynchron ausgeführt werden.

Weitere Informationen finden Sie unter Optionen für die Rückgabeverarbeitung von benutzerdefinierten Aktionen.

Optionen für die Ausführungsplanung

Optionsflags sind verfügbar, um die potenzielle Mehrfachausführung benutzerdefinierter Aktionen zu steuern. Weitere Informationen finden Sie unter Planungsoptionen für die Ausführung von benutzerdefinierten Aktionen.

Optionen für die skriptinterne Ausführung

Die benutzerdefinierte Aktion verwendet diese Option nicht.

Rückgabewerte

Der Rückgabestatus von Benutzerabbruch, Fehler, Anhalten oder Erfolg einer gleichzeitigen Installation wird auf die gleiche Weise wie jede andere Aktion verarbeitet. Beachten Sie jedoch, dass Windows Installer die Rückgabewerte aller 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 Aktion ERROR_SUCCESS zurückgab. Weitere Informationen finden Sie unter Protokollierung von Aktionsrückgabewerten.

Hinweis: Wenn bei einer gleichzeitigen Installation msidbCustomActionTypeContinue festgelegt ist, wird eine Rückgabe von ERROR_INSTALL_USEREXIT, ERROR_INSTALL_REBOOT, ERROR_INSTALL_REBOOT_NOW oder ERROR_SUCCESS_REBOOT_REQUIRED als ERROR_SUCCESS behandelt. Dies bedeutet, dass die Anforderung für den Neustart ignoriert wird, wenn Sie msidbCustomActionTypeContinue festlegen und die gleichzeitige Installation einen Neustart erfordert. 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 Neustartflag wird auf einen Neustart am Ende der Installation festgelegt.
ERROR_INSTALL_REBOOT_NOW	Ein Neustart ist erforderlich, bevor die Installation abgeschlossen wird. Der Neustart wird sofort verarbeitet.
ERROR_SUCCESS_REBOOT_REQUIRED	Ein Neustart war erforderlich, wurde aber unterdrückt.

 

Bemerkungen

Ein bedingter Ausdruck ist erforderlich, um die gleichzeitige Installation entweder bei der Installation oder Entfernung der zugeordneten Komponente oder des zugehörigen Features zu aktivieren.

Zugehörige Themen

Gleichzeitige Installationen

Referenz zu benutzerdefinierten Aktionen

Informationen zu benutzerdefinierten Aktionen

Verwenden benutzerdefinierter Aktionen